RtlAppendUnicodeStringToString function (wdm.h)

The RtlAppendUnicodeStringToString routine concatenates two Unicode strings.

Syntax

NTSYSAPI NTSTATUS RtlAppendUnicodeStringToString(
  [in, out] PUNICODE_STRING  Destination,
  [in]      PCUNICODE_STRING Source
);

Parameters

[in, out] Destination

Pointer to a buffered Unicode string.

[in] Source

Pointer to the buffered string to be concatenated.

Return value

RtlAppendUnicodeStringToString can return one of the following:

Return code	Description
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.

Remarks

RtlAppendUnicodeStringToString copies bytes from the source to the specified destination string, after the current contents of the destination string and the destination length is incremented by the number of bytes copied.

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

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 2000.
Target Platform	Universal
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	See Remarks section.

See also

RtlAppendUnicodeToString