RtlInitializeUnicodePrefix function (ntifs.h)

Article
02/22/2024

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