RtlAppendUnicodeStringToString

RtlAppendUnicodeStringToString

The RtlAppendUnicodeStringToString routine concatenates two Unicode strings.

NTSTATUS
RtlAppendUnicodeStringToString(
    IN OUT PUNICODE_STRING Destination,
    IN PUNICODE_STRING Source
    );

Parameters

Destination

Pointer to a buffered Unicode string.

Source

Pointer to the buffered string to be concatenated.

Return Value

RtlAppendUnicodeStringToString can return one of the following:

STATUS_SUCCESS

The source string was successfully appended to the destination counted string. The destination string length is updated to include the appended bytes.

STATUS_BUFFER_TOO_SMALL

The destination string length is too small to allow the source string to be concatenated. Accordingly, the destination string length is not updated.

Comments

RtlAppendUnicodeStringToString copies bytes from the source up to the length of the destination buffer.

The Destination and Source buffers must be resident if the caller is running at IRQL >= DISPATCH_LEVEL.

Requirements

IRQL: See Comments section.

Headers: Declared in Wdm.h. Include Wdm.h, Ntddk.h, or Ntifs.h.