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.