RtlDuplicateUnicodeString(3w)

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

Defined in "winternl.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/ntdll/rtlstr.c".

Debug channel "ntdll".

Wine API Aug 2010 RtlDuplicateUnicodeString(3w)