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 例程負責同步處理前置詞數據表的存取權。 快速 Mutex 是用於此用途的最有效率同步處理機制。

如需其他字串處理例程的資訊，請參閱 Run-Time Library (RTL) 例程。

規格需求

需求	值
最低支援的用戶端	Windows XP
最低支援的伺服器	Windows Server 2003
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

另請參閱

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix