RtlInsertUnicodePrefix 関数 (ntifs.h)

[アーティクル]
08/07/2023

RtlInsertUnicodePrefix ルーチンは、Unicode プレフィックステーブルに新しい要素を挿入します。

構文

NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
  [in]  PUNICODE_PREFIX_TABLE            PrefixTable,
  [in]  __drv_aliasesMem PUNICODE_STRING Prefix,
  [out] PUNICODE_PREFIX_TABLE_ENTRY      PrefixTableEntry
);

パラメーター

[in] PrefixTable

プレフィックステーブルへのポインター。テーブルは、RtlInitializeUnicodePrefix を呼び出して初期化されている必要があります。

[in] Prefix

PrefixTableEntry の要素と共に挿入される名前文字列へのポインター。

[out] PrefixTableEntry

新しいプレフィックスに要素を挿入するには、呼び出し元によって割り当てられたストレージへのポインター (少なくとも sizeof(UNICODE_PREFIX_TABLE_ENTRY) である必要があります。 RtlInsertUnicodePrefix は、呼び出し元が不透明と見なす必要があるこの要素を初期化します。

戻り値

RtlInsertUnicodePrefix は、新しい要素がプレフィックステーブルに挿入された場合は TRUE を 返し、プレフィックステーブルに重複する要素が既に存在する場合は FALSE を 返します。

注釈

テーブル内の各プレフィックスエントリは、ファイルシステムボリュームのルートディレクトリに対する相対パス名です。整形式にするには、プレフィックスは 1 つの円記号 () で始まる必要があります。

新しい要素を挿入した後、 RtlInsertUnicodePrefix はプレフィックステーブルの表示ツリーを再調整します。

ファイルシステムでは、他の Rtl を使用する前にプレフィックステーブルを初期化するために RtlInitializeUnicodePrefix を呼び出す必要があります 。UnicodePrefix ルーチン。初期化されたプレフィックステーブル構造は不透明と見なす必要があります。

Rtl の呼び出し元 。.UnicodePrefix ルーチンは、プレフィックステーブルへのアクセスを同期する役割を担います。高速ミューテックスは、この目的で使用する最も効率的な同期メカニズムです。

その他の文字列処理ルーチンの詳細については、「ランタイムライブラリ (RTL) ルーチン」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL