RtlUnicodeStringToAnsiString(3w)

RtlUnicodeStringToAnsiString3w

Usage

NTSTATUS RtlUnicodeStringToAnsiString
(
STRING* ansi,
const UNICODE_STRING* uni,
BOOLEAN doalloc
)

Params

ansi [In/Out] Destination for the ansi string.

uni [In] Unicode string to be converted.

doalloc [In] TRUE=Allocate new buffer for ansi,FALSE=Use existing buffer.

Overview

Converts a unicode string to an ansi string.

Returns

Success: STATUS_SUCCESS. ansi 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.

Notes

This function always writes a terminating ' '. It performs a partial copy if ansi is too small.

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.