RtlAnsiStringToUnicodeString3w
Usage
NTSTATUS RtlAnsiStringToUnicodeString
(
PUNICODE_STRING uni,
PCANSI_STRING ansi,
BOOLEAN doalloc
)
Params
uni [In/Out] Destination for the unicode string.
ansi [In] Ansi string to be converted.
doalloc [In] TRUE=Allocate new buffer for uni,FALSE=Use existing buffer.
Overview
Converts an ansi string to a unicode string.
Returns
Success: STATUS_SUCCESS. uni contains the converted string
Failure: STATUS_BUFFER_OVERFLOW, if doalloc is FALSE and ansi is too small. STATUS_NO_MEMORY, if doalloc is TRUE and the allocation fails. STATUS_INVALID_PARAMETER_2, if the unicode string would be larger than 65535.
Notes
This function always writes a terminating ' '.
Implementation
Declared in "winternl.h".
Implemented in "dlls/ntdll/rtlstr.c".
Debug channel "ntdll".
Releases
4 releases since Debian 4.0 (Etch); the text changed 3 times.