英語で読む

次の方法で共有

RtlInitUTF8StringEx 関数 (ntifs.h)

  • [アーティクル]

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

構文

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

パラメーター

DestinationString

初期化するUTF8_STRING構造体へのポインター。 ntdef.h ヘッダー ファイルは、この構造体を ANSI_STRING 構造体と同じに定義します。

SourceString

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

戻り値

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

備考

RtlInitUTF8StringEx DestinationString UTF8_STRING構造体のメンバーが次のように設定されます。

  • SourceString のポインター値を Buffer メンバーにコピーします。

  • Length メンバーを、終端の null を除くソース文字列の長さをバイト単位で設定します。

  • MaximumLength メンバーを、終端の null を含むソース文字列の長さ (バイト単位) に設定します。

SourceString が NULL 場合、Length と MaximumLength は両方とも 0 に設定されます。

RtlInitStringEx では、SourceString によって指されるソース文字列変更されません。

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

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 2004
ヘッダー ntifs.h

関連項目

ANSI_STRING