Concatenates multiple strings in one operation
Syntax
NTSTATUS WINAPI RtlMultiAppendUnicodeStringBuffer (
PRTL_UNICODE_STRING_BUFFER pStrBuffer,
ULONG numAddends,
PCUNICODE_STRING pAddends
)
Parameters
- pStrBuffer
- The buffer to be appended to. If the unicode string portion has a length, its pointer must point to pStrBuffer->ByteBuffer.Buffer or the function will not function correctly
- numAddends
- Count of elements in the pAddends array
- pAddends
- An array of UNICODE_STRING structures to be appended in order
Return Value
STATUS_SUCCESS on success, an standard error code otherwise
Remarks
numAddends cannot exceed 65534 (0xFFFE). Likewise the sum of total length of the pAddends array plus the starting length of pStrBuffer also cannot exceed 65534. The function returns STATUS_NAME_TOO_LONG (0xC0000106) in both of these cases.
For the definition of the RTL_UNICODE_STRING_BUFFER structure, see RtlAppendPathElement.