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 |