RtlUnicodeStringToAnsiString.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

RtlUnicodeStringToAnsiString (NTDLL.@)

SYNOPSIS

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.

DESCRIPTION

Converts an 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

Defined in "winternl.h".

Implemented in "dlls/ntdll/rtlstr.c".

Debug channel "ntdll".