RtlInsertUnicodePrefix function (ntifs.h)
The RtlInsertUnicodePrefix routine inserts a new element into a Unicode prefix table.
Syntax
NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] __drv_aliasesMem PUNICODE_STRING Prefix,
[out] PUNICODE_PREFIX_TABLE_ENTRY PrefixTableEntry
);
Parameters
[in] PrefixTable
Pointer to the prefix table. The table must have been initialized by calling RtlInitializeUnicodePrefix.
[in] Prefix
Pointer to the name string to be inserted with the element at PrefixTableEntry.
[out] PrefixTableEntry
Pointer to caller-allocated storage, which must be at least sizeof(UNICODE_PREFIX_TABLE_ENTRY), for the element to be inserted for the new prefix. RtlInsertUnicodePrefix initializes this element, which should be considered opaque by the caller.
Return value
RtlInsertUnicodePrefix returns TRUE if the new element was inserted in the prefix table, or it returns FALSE if a duplicate element already exists in the prefix table.
Remarks
Each prefix entry in the table is a pathname relative to the root directory of a file system volume. To be well-formed, the prefix must begin with a single backslash ().
After inserting the new element, RtlInsertUnicodePrefix rebalances the prefix table's splay tree.
File systems must call RtlInitializeUnicodePrefix to initialize the prefix table before using any other Rtl..UnicodePrefix routines on it. The initialized prefix table structure should be considered opaque.
Callers of the Rtl..UnicodePrefix routines are responsible for synchronizing access to the prefix table. A fast mutex is the most efficient synchronization mechanism to use for this purpose.
For information about other string-handling routines, see Run-Time Library (RTL) Routines.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP |
| Minimum supported server | Windows Server 2003 |
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |