UlFromSzHex

適用対象: Outlook 2013 | Outlook 2016

null で終わる 16 進数の文字列を符号なし長整数に変換します。

プロパティ	値
ヘッダー ファイル:	Mapidefs.h
実装元:	MAPI
呼び出し元:	クライアント アプリケーションとサービス プロバイダー

ULONG UlFromSzHex(
LPCSTR lpsz
);

パラメーター

lpsz

[in]変換する null で終わる文字列へのポインター。 lpsz パラメーターは、65536 文字を超えてはなりません。

戻り値

UlFromSzHex は 符号なし長整数を返します。 文字列が少なくとも 1 つの 16 進数字で始まらない場合は、0 が返されます。

注釈

UlFromSzHex 関数は、16 進数ではない文字列の最初の文字に達すると変換を停止します。 たとえば、文字列 "5a" を指定すると、 UlFromSzHex は 整数値 90 を返します。 文字列 "5g5h" を指定すると、関数は整数値 5 を返します。 文字列 "g5h5" を指定すると、 UlFromSzHex は 0 を返します。

UlFromSzHex はダイアクリティカルな違いに敏感ですが、16 進数の場合は 'a' から 'f' と 'A' から 'F' の両方を使用できます。 Unicode および DBCS 形式の文字列がサポートされています。 lpsz の長さの制限は文字数であり、必ずしもバイト単位ではありません。