次の方法で共有

RtlInitStringEx 関数 (ntifs.h)

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

構文

NTSYSAPI NTSTATUS RtlInitStringEx(
  [out]          PSTRING               DestinationString,
  [in, optional] __drv_aliasesMem PCSZ SourceString
);

パラメーター

[out] DestinationString

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

[in, optional] SourceString

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

戻り値

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

備考

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

このルーチンは、SourceString ポインター値を、DestinationString が指す STRING 構造体の 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。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 「解説」セクションを参照してください。

関連項目

ANSI_STRING