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。

注解

文件系统在使用任何其他 Rtl.之前，必须调用 RtlInitializeUnicodePrefix 来初始化前缀表 。它的 UnicodePrefix 例程。 应将初始化的前缀表结构视为不透明。

Rtl. 的调用方。UnicodePrefix 例程负责同步对前缀表的访问。 快速互斥体是用于此目的的最有效同步机制。

有关其他字符串处理例程的信息，请参阅 运行时库 (RTL) 例程。

要求

要求 值
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix