.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH RtlUnicodeStringToAnsiString 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBRtlUnicodeStringToAnsiString\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlUnicodeStringToAnsiString
 (
  STRING*               \fIansi\fR,
  const UNICODE_STRING* \fIuni\fR,
  BOOLEAN               \fIdoalloc\fR
 )

.SH PARAMS
\fIansi\fR \fB[In/Out]\fR  Destination for the \fIansi\fR string.
.PP
\fIuni\fR \fB[In]\fR  Unicode string to be converted.
.PP
\fIdoalloc\fR \fB[In]\fR  \fBTRUE\fR=Allocate new buffer for \fIansi\fR,\fBFALSE\fR=Use existing buffer.
.PP

.SH DESCRIPTION
.PP
Converts a unicode string to an \fIansi\fR string. 

.SH RETURNS
.PP
\fBSuccess:\fR \fBSTATUS_SUCCESS\fR. \fIansi\fR contains the converted string 
.PP
\fBFailure:\fR \fBSTATUS_BUFFER_OVERFLOW\fR, if \fIdoalloc\fR is \fBFALSE\fR and \fIansi\fR is too small. \fBSTATUS_NO_MEMORY\fR, if \fIdoalloc\fR is \fBTRUE\fR and the allocation fails. 

.SH NOTES
.PP
This function always writes a terminating \fB'\0'\fR. It performs a partial copy if \fIansi\fR is too small. 

.SH IMPLEMENTATION
.PP
Declared in \fB"winternl.h"\fR. 
.PP
Implemented in \fB"dlls/ntdll/rtlstr.c"\fR. 
.PP
Debug channel \fB"ntdll"\fR.