RtlInitUnicodeString
The RtlInitUnicodeString routine initializes a counted Unicode string.
VOID
RtlInitUnicodeString(
IN OUT
PUNICODE_STRING
DestinationString
,
IN PCWSTR
SourceString
);
Parameters
DestinationString Pointer to the UNICODE_STRING structure to be initialized. SourceString Pointer to a null-terminated Unicode string with which to initialize the counted string.Return Value
None
Comments
The Buffer member of 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 Xxx String routines cannot be called at IRQL > PASSIVE_LEVEL.
Requirements
IRQL: (See Comments section)
Headers: Declared in wdm.h . Include wdm.h , ntddk.h, or ntifs.h .