RtlAppendUnicodeToString

RtlAppendUnicodeToString

The RtlAppendUnicodeToString routine concatenates the supplied Unicode string to a buffered Unicode string.

NTSTATUS
RtlAppendUnicodeToString(
    IN OUT PUNICODE_STRING Destination,
    IN PCWSTR Source
    );

Parameters

Destination

Pointer to the buffered string.

Source

Pointer to the string to be appended to the Destination string.

Return Value

RtlAppendUnicodeToString 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 was too small to allow the source string to be appended, so the destination string length is not updated.

Comments

RtlAppendUnicodeToString copies bytes from the source string to the destination string up to the end of the destination buffer.

The Destination buffer 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.