RtlUTF8StringToUnicodeString 関数 (wdm.h)

  • [アーティクル]

RtlUTF8StringToUnicodeString 関数は、現在のシステム ロケール情報に従って、指定された UTF8 ソース文字列を Unicode 文字列に変換します。

構文

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

パラメーター

DestinationString

変換された Unicode 文字列を保持する UNICODE_STRING 構造体へのポインター。

AllocateDestinationString が TRUE の場合、ルーチンは文字列データを保持する新しいバッファーを割り当て、DestinationString の Buffer メンバーを更新して新しいバッファーを指し示し、最大長フィールドを設定します。 それ以外の場合、ルーチンは現在指定されているバッファーを使用して文字列を保持します。

SourceString

Unicode に変換する UTF8 文字列へのポインター。

AllocateDestinationString

このルーチンが宛先文字列のバッファー領域を割り当てる必要があるかどうかを指定します。 その場合、呼び出し元は RtlFreeUnicodeString を呼び出してバッファーの割り当てを解除する必要があります。

戻り値

変換が成功した場合、 RtlUTF8StringToUnicodeString はSTATUS_SUCCESSを返します。 失敗した場合、ルーチンはメモリを割り当てたり、変換を実行したりしません。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 2004
Header wdm.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

RtlFreeUnicodeString