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 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".