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 ，如果前置詞數據表中已經有重複的專案，則會傳回 FALSE 。
備註
數據表中的每個前置詞專案都是相對於文件系統磁碟區根目錄的路徑名稱。 若要正確形成，前置詞開頭必須是單一反斜杠 () 。
插入新元素之後， RtlInsertUnicodePrefix 會重新平衡前置詞數據表的播放樹狀結構。
文件系統必須先呼叫 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 |