RtlInitUnicodeString

VOID
RtlInitUnicodeString(

IN OUT PUNICODE_STRING DestinationString,
IN PCWSTR SourceString
);

RtlInitUnicodeString initializes a counted Unicode string.

Parameters

DestinationString

Points to the buffer for a counted Unicode string to be initialized.

SourceString

Points to a zero-terminated Unicode string with which to initialize the counted string.

Comments

DestinationString is initialized to point to SourceString. The length and maximum length for DestinationString are initialized to the length of SourceString. If SourceString is NULL, the length is zero.

Callers of RtlInitUnicodeString can be running at IRQL <= DISPATCH_LEVEL if the DestinationString buffer is nonpageable. Usually, callers run at IRQL PASSIVE_LEVEL because most other Rtl..String routines cannot be called at raised IRQL.

See Also

RtlInitAnsiString, RtlInitString