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 が指すカウントされた文字列を初期化するために使用されます。
戻り値
SourceString が長すぎる場合、RtlInitUTF8StringEx は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で実行されます。これは、他のほとんどの RtlXxx文字列 ルーチンは IRQL > PASSIVE_LEVELで呼び出すことができないためです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 バージョン 2004 |
Header | ntifs.h |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示