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.

Headers

Declared in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

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.

See Also

RtlAppendUnicodeToString