Wine API: RtlUnicodeStringToAnsiString

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 '\0'. It performs a partial copy if ansi is too small.

IMPLEMENTATION

Declared in "include/winternl.h". gitlab.winehq.org/wine/wine/blob/master/include/winternl.h

Implemented in "dlls/ntdll/rtlstr.c". gitlab.winehq.org/wine/wine/blob/master/dlls/ntdll/rtlstr.c

Debug channel "ntdll".