RtlAppendStringToString function (ntifs.h)

Article
02/22/2024

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(
  [in, out] PSTRING      Destination,
  [in]      const STRING *Source
);

Parameters

[in, out] Destination

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

[in] 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 Run-Time Library (RTL) Routines.

Requirements

Requirement	Value
Minimum supported client	Windows 2000
Target Platform	Universal
Header	ntifs.h (include Ntifs.h, FltKernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL