RtlInitializeUnicodePrefix function

The RtlInitializeUnicodePrefix routine initializes a prefix table.

Syntax

NTSYSAPI VOID RtlInitializeUnicodePrefix(
  PUNICODE_PREFIX_TABLE PrefixTable
);

Parameters

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 Strings.

Requirements

   
Windows version Windows XP 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