StrToInt64ExW 関数 (shlwapi.h)
10 進数または 16 進数の値を表す文字列を 64 ビットの整数に変換します。
構文
BOOL StrToInt64ExW(
[in] PCWSTR pszString,
STIF_FLAGS dwFlags,
[out] LONGLONG *pllRet
);
パラメーター
[in] pszString
種類: PCTSTR
変換する null で終わる文字列へのポインター。 文字列の有効な形式の詳細については、「解説」セクションを参照してください。
dwFlags
種類: STIF_FLAGS
pszString を 64 ビット整数に変換する方法を指定する次のいずれかの値。
STIF_DEFAULT
pszString の文字列には、10 進値の表現が含まれています。
STIF_SUPPORT_HEX
pszString の文字列には、10 進数または 16 進数の値の表現が含まれています。 16 進数表現では、文字 A から F は大文字と小文字が区別されません。
[out] pllRet
種類: LONGLONG*
変換された文字列の 64 ビット整数値を受け取る LONGLONG 型の変数へのポインター。 たとえば、文字列 "123" の場合、この値が指す整数は値 123 を受け取ります。
この関数が FALSE を返す場合、この値は未定義です。
返される値が LONGLONG 型の変数に含まれるには大きすぎる場合、このパラメーターには値の 64 個の下位ビットが含まれます。 それ以降の上位ビットは失われます。
戻り値
種類: BOOL
文字列が変換された場合は TRUE を 返します。それ以外の場合 は FALSE。
注釈
pszString パラメーターが指す文字列は、正常に解析するには、次のいずれかの形式である必要があります。
- このフォームは、どちらのフラグの下でも 10 進値として受け入れられます。 ''' 構文 (省略可能な空白)(省略可能な記号)(1 桁以上の 10 進数) '''
- これらのフォームは、STIF_SUPPORT_HEX フラグが渡されるときに 16 進数の値に必要です。
''' 構文 (省略可能な空白)(省略可能な記号)0x(1 桁以上の 16 進数) '''
(optional white space)(optional sign)0X(one or more hexadecimal digits)
pllRet が NULL の場合、変換を実行しない場合でも、文字列を変換できる場合、関数は TRUE を返します。
注意
shlwapi.h ヘッダーは、STRToInt64Ex をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlwapi.h |
Library | Shlwapi.lib |
[DLL] | Shlwapi.dll (バージョン 5.0 以降) |