NAME¶

RtlDuplicateUnicodeString (NTDLL.@)

SYNOPSIS¶

NTSTATUS RtlDuplicateUnicodeString
(
int add_nul,
const UNICODE_STRING* source,
UNICODE_STRING* destination
)

PARAMS¶

add_nul [In] flag. source [In] Unicode string to be duplicated. destination [Out] destination for the duplicated unicode string.

DESCRIPTION¶

Duplicates a unicode string.

RETURNS¶

Success: STATUS_SUCCESS. destination contains the duplicated unicode string. Failure: STATUS_INVALID_PARAMETER, if one of the parameters is illegal. STATUS_NO_MEMORY, if the allocation fails.

NOTES¶

For add_nul there are several possible values: 0 = destination will not be ' ' terminated, 1 = destination will be ' ' terminated, 3 = like 1 but for an empty source string produce ' ' terminated empty Buffer instead of assigning NULL to the Buffer. Other add_nul values are invalid.

IMPLEMENTATION¶

Declared in "winternl.h". Implemented in "dlls/ntdll/rtlstr.c". Debug channel "ntdll".