RtlInitializeUnicodePrefix function (ntifs.h)

The RtlInitializeUnicodePrefix routine initializes a prefix table.

Syntax

NTSYSAPI VOID RtlInitializeUnicodePrefix(
  [out] PUNICODE_PREFIX_TABLE PrefixTable
);

Parameters

[out] PrefixTable

Pointer to caller-allocated buffer, which must be at least sizeof(UNICODE_PREFIX_TABLE), for the prefix table header. RtlInitializeUnicodePrefix initializes this header, which should be considered opaque by the caller.

Return value

None

Remarks

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

See also

ExInitializeFastMutex

RtlFindUnicodePrefix

RtlInsertUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix