RtlInitUTF8StringEx 関数 (wdm.h)

RtlInitUTF8StringEx ルーチンは、カウントされた UTF-8 文字の文字列を初期化します。

構文

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

パラメーター

DestinationString

初期化する UTF8_STRING 構造体へのポインター。 Ntdef.h ヘッダー ファイルでは、この構造体が STRING 構造体と同じになるように定義されています。

SourceString

null 終端文字列へのポインター。 この文字列は、 DestinationString が指すカウントされた文字列を初期化するために使用されます。

戻り値

SourceString が長すぎる場合は、STATUS_NAME_TOO_LONGを返します。 それ以外の場合、このルーチンはSTATUS_SUCCESSを返します。

注釈

このルーチンは、SourceString ポインター値を DestinationString が指すUTF8_STRING構造体の Buffer メンバーにコピーします。 この構造体の Length メンバーは、終端の null を除くソース文字列の長さ (バイト単位) に設定されます。 構造体の MaximumLength メンバーは、終端の null を含むソース文字列の長さ (バイト単位) に設定されます。 SourceString が NULL の場合、Length と MaximumLength の両方が 0 に設定されます。

RtlInitUTF8StringEx では、 SourceString が指すソース文字列は変更されません。

DestinationString バッファーがページ不可能な場合、RtlInitUTF8StringEx の呼び出し元は IRQL <= DISPATCH_LEVELで実行できます。 通常、呼び出し元は IRQL = PASSIVE_LEVELで実行されます。これは、他のほとんどの RtlXxx文字列 ルーチンは IRQL > PASSIVE_LEVELで呼び出すことができないためです。

要件

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

こちらもご覧ください

RtlInitAnsiString