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。
言论
表中的每个前缀条目都是相对于文件系统卷根目录的路径名称。 为了格式正确，前缀必须以单个反斜杠开头（）。
插入新元素后，RtlInsertUnicodePrefix 重新平衡前缀表的 splay 树。
文件系统必须先调用 RtlInitializeUnicodePrefix 来初始化前缀表，然后再使用任何其他 Rtl.。UnicodePrefix 它的例程。 应将初始化的前缀表结构视为不透明。
Rtl. 的调用方。UnicodePrefix 例程负责同步对前缀表的访问。 快速互斥体是用于此目的最有效的同步机制。
有关其他字符串处理例程的信息，请参阅 Run-Time Library （RTL） 例程。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | 普遍 |
| 标头 | ntifs.h （include Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |