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

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

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

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

.SH RETURNS
.PP
\fBSuccess:\fR \fBSTATUS_SUCCESS\fR. \fIuni\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 the allocation fails. \fBSTATUS_INVALID_PARAMETER_2\fR, if the unicode string would be larger than \fB65535.\fR 

.SH NOTES
.PP
This function always writes a terminating \fB'\0'\fR. 

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