Export (0) Print
Expand All
Expand Minimize
1 out of 2 rated this helpful - Rate this topic

RtlAppendUnicodeToString routine

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

Syntax


NTSTATUS RtlAppendUnicodeToString(
  _Inout_   PUNICODE_STRING Destination,
  _In_opt_  PCWSTR Source
);

Parameters

Destination [in, out]

A pointer to the buffered string.

Source [in, optional]

A pointer to the null-terminated string to append to the Destination string.

Return value

RtlAppendUnicodeToString can return one of the following:

Return codeDescription
STATUS_SUCCESS

The source string was successfully appended to the destination string, and the destination string length was updated to include the appended bytes.

STATUS_BUFFER_TOO_SMALL

The destination string buffer is too small to allow the source string to be appended, so the destination string length is not updated and the contents of the destination string buffer are not changed.

 

Remarks

RtlAppendUnicodeToString appends the source string to the end of the destination string.

If the destination buffer is not large enough to contain the string that would result from concatenating the source and destination strings (not including the null character that terminates the source string), the routine returns STATUS_BUFFER_TOO_SMALL and leaves the destination string unchanged.

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

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

See Remarks section.

See also

RtlAppendUnicodeStringToString

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.