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

.SH NAME
\fBRtlIntegerToUnicodeString\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlIntegerToUnicodeString
 (
  ULONG           \fIvalue\fR,
  ULONG           \fIbase\fR,
  UNICODE_STRING* \fIstr\fR
 )

.SH PARAMS
\fIvalue\fR \fB[In]\fR  Value to be converted.
.PP
\fIbase\fR \fB[In]\fR  Number \fIbase\fR for conversion (allowed \fB0\fR,2,8,10 or \fB16\fR).
.PP
\fIstr\fR \fB[Out]\fR  Destination for the converted \fIvalue\fR.
.PP

.SH DESCRIPTION
.PP
Converts an unsigned integer to a \fB'\0'\fR terminated unicode string. 

.SH RETURNS
.PP
\fBSuccess:\fR \fBSTATUS_SUCCESS\fR. \fIstr\fR contains the converted number 
.PP
\fBFailure:\fR \fBSTATUS_INVALID_PARAMETER\fR, if \fIbase\fR is not \fB0\fR, \fB2\fR, \fB8\fR, \fB10\fR or \fB16.\fR \fBSTATUS_BUFFER_OVERFLOW\fR, if \fIstr\fR is too small to hold the string (with the \fB'\0'\fR termination). In this case \fIstr\fR\fI->Length\fR is set to the length, the string would have (which can be larger than the MaximumLength). 

.SH NOTES
.PP
Instead of \fIbase\fR \fB0\fR it uses \fB10\fR as \fIbase\fR. If \fIstr\fR is \fBNULL\fR it crashes, as the native function does. 

.SH DIFFERENCES
.PP
Do not return \fBSTATUS_BUFFER_OVERFLOW\fR when the string is long enough. The native function does this when the string would be longer than \fB16\fR characters even when the string parameter is long enough. 

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