Wine API: RtlDuplicateUnicodeString

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 '\0' terminated, 1 = destination will be '\0' terminated, 3 = like 1 but for an empty source string produce '\0' terminated empty Buffer instead of assigning NULL to the Buffer. Other add_nul values are invalid.

IMPLEMENTATION

Declared in "include/winternl.h". gitlab.winehq.org/wine/wine/blob/master/include/winternl.h

Implemented in "dlls/ntdll/rtlstr.c". gitlab.winehq.org/wine/wine/blob/master/dlls/ntdll/rtlstr.c

Debug channel "ntdll".