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 プレフィックス テーブルの再生ツリーを再調整します。
ファイル システム RtlInitializeUnicodePrefix を呼び出してプレフィックス テーブルを初期化してから、他の Rtl を使用する必要があります。UnicodePrefix ルーチンです。 初期化されたプレフィックス テーブル構造は不透明と見なす必要があります。
Rtl の呼び出し元。.UnicodePrefix ルーチンは、プレフィックス テーブルへのアクセスを同期する役割を担います。 高速ミューテックスは、この目的に使用する最も効率的な同期メカニズムです。
その他の文字列処理ルーチンについては、「Run-Time ライブラリ (RTL) ルーチン」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP |
| サポートされる最小サーバー | Windows Server 2003 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ntifs.h (Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |
関連項目
RtlFindUnicodePrefix の
RtlInitializeUnicodePrefix の
RtlNextUnicodePrefix を する
RtlRemoveUnicodePrefix の