RtlInitUnicodeString function (wdm.h)

  • Article

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