RtlUnicodeStringToUTF8String 関数 (wdm.h)

RtlUnicodeStringToUTF8String 関数は、指定された Unicode ソース文字列を UTF8 文字列に変換します。

構文

NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
  PUTF8_STRING     DestinationString,
  PCUNICODE_STRING SourceString,
  BOOLEAN          AllocateDestinationString
);

パラメーター

DestinationString

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

SourceString

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

AllocateDestinationString

このルーチンが DestinationString のバッファー領域を割り当てる場合は TRUE。 その場合は、 RtlFreeUTF8String を呼び出してバッファーの割り当てを解除する必要があります。

戻り値

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

要件

こちらもご覧ください

RtlFreeUTF8String