RtlInsertUnicodePrefix 函数 (ntifs.h)

  • 项目

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

指向调用方分配的存储的指针，该 存储的大小 必须至少为 (UNICODE_PREFIX_TABLE_ENTRY) ，才能为新前缀插入元素。 RtlInsertUnicodePrefix 初始化此元素，调用方应将其视为不透明。

返回值

如果新元素插入到前缀表中，则 RtlInsertUnicodePrefix 返回 TRUE;如果前缀表中已存在重复元素，则 RtlInsertUnicodePrefix 返回 FALSE。

注解

表中的每个前缀条目都是相对于文件系统卷的根目录的路径名。 要使格式良好，前缀必须以单个反斜杠 () 开头。

插入新元素后， RtlInsertUnicodePrefix 会重新平衡前缀表的 splay 树。

文件系统在使用任何其他 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

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING