RtlInitUnicodeString function (wdm.h)

For more information, see the WdmlibRtlInitUnicodeStringEx function.

Syntax

NTSYSAPI VOID RtlInitUnicodeString(
  [out]          PUNICODE_STRING         DestinationString,
  [in, optional] __drv_aliasesMem PCWSTR SourceString
);

Parameters

[out] DestinationString

For more information, see the WdmlibRtlInitUnicodeStringEx function.

[in, optional] SourceString

For more information, see the WdmlibRtlInitUnicodeStringEx function.

Return value

For more information, see the WdmlibRtlInitUnicodeStringEx function.

Remarks

The RTL_CONSTANT_STRING macro creates a string or Unicode string structure to hold a counted string.

STRING RTL_CONSTANT_STRING(
  [in]  PCSZ SourceString
);

UNICODE_STRING RTL_CONSTANT_STRING(
  [in]  PCWSTR SourceString
);

RTL_CONSTANT_STRING returns either a string structure or Unicode string structure.

The RTL_CONSTANT_STRING macro replaces the RtlInitAnsiString, RtlInitString, and RtlInitUnicodeString routines when passing a constant string.

You can use RTL_CONSTANT_STRING to initialize global variables.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 2000.
Target Platform	Universal
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	For more information, see the Remarks section of the WdmlibRtlInitUnicodeStringEx function.

See also

RtlUnicodeStringInit

RtlUnicodeStringInitEx

UNICODE_STRING

WdmlibRtlInitUnicodeStringEx