RtlAnsiStringToUnicodeString(3w)

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.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.