RtlNextUnicodePrefix 関数 (ntifs.h)

RtlNextUnicodePrefix ルーチンは、Unicode プレフィックス テーブル内の要素を列挙するために使用されます。

構文

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] BOOLEAN               Restart
);

パラメーター

[in] PrefixTable

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

[in] Restart

列挙がテーブルの最初の要素から開始する場合は TRUE に設定します。 前の呼び出しから列挙を再開する場合は 、FALSE に 設定します。

テーブル内のすべての要素を列挙するには、 次のように RtlNextUnicodePrefix を使用します。

for (p = RtlNextUnicodePrefix ( Table, TRUE );
     p != NULL;
     p = RtlNextUnicodePrefix ( Table, FALSE )) {
        // Process the element pointed to by p
}

戻り値

RtlNextUnicodePrefix は、次の要素 (存在する場合) へのポインターを返します。 テーブルにそれ以上の要素がない場合、 RtlNextUnicodePrefix は NULL を返します。

注釈

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

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

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

要件

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

こちらもご覧ください

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix