RtlAppendStringToString function

The RtlAppendStringToString routine concatenates two counted strings. It copies bytes from the source up to the length of the destination buffer.

Syntax

NTSYSAPI NTSTATUS RtlAppendStringToString(
  PSTRING      Destination,
  const STRING *Source
);

Parameters

Destination

A pointer to a counted string to which the string at Source should be appended.

Source

A pointer to a counted string to be appended to the string at Destination.

Return Value

The RtlAppendStringToString routine returns STATUS_SUCCESS if it appended the string at Source to the string at Destination. RtlAppendStringToString returns STATUS_BUFFER_TOO_SMALL if the MaximumLength of the Destination string is too small to allow the source string to be appended.

Remarks

The sum of the Length members of the Destination and Source strings must be less than or equal to the MaximumLength of the Destination string.

For information about other string-handling routines, see Strings.

Requirements

   
Windows version Available in Microsoft Windows 2000, and later versions of all Windows operating systems.
Target Platform Universal
Header ntifs.h (include Ntifs.h, FltKernel.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "<= APC_LEVEL"

See Also

RtlAppendUnicodeStringToString

RtlAppendUnicodeToString

RtlInitString