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

.SH NAME
\fBRtlUnicodeStringToOemString\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlUnicodeStringToOemString
 (
  STRING*               \fIoem\fR,
  const UNICODE_STRING* \fIuni\fR,
  BOOLEAN               \fIdoalloc\fR
 )

.SH DESCRIPTION
.PP
Converts a Rtl Unicode string to an \fBOEM\fR string. 

.SH PARAMS
\fIoem\fR \fB[Out]\fR  Destination for \fBOEM\fR string.
.PP
\fIuni\fR \fB[In]\fR  Source Unicode string.
.PP
\fIdoalloc\fR \fB[In]\fR  \fBTRUE\fR=Allocate new buffer for \fIoem\fR,\fBFALSE\fR=Use existing buffer.
.PP

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

.SH NOTES
.PP
If \fIdoalloc\fR is \fBTRUE\fR, the length allocated is \fIuni\fR\fI->Length\fR + \fB1.\fR This function always \fB'\0'\fR terminates the string returned. 

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