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

.SH NAME
\fBRtlInt64ToUnicodeString\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlInt64ToUnicodeString
 (
  ULONGLONG       \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
Convert a large 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
\fB-\fR Accept \fIbase\fR \fB0\fR as \fB10\fR instead of crashing as native function does. 
.PP
\fB-\fR 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 \fB31\fR characters even when the string parameter is long enough. 
.PP
\fB-\fR The native function does produce garbage or \fBSTATUS_BUFFER_OVERFLOW\fR for \fIbase\fR \fB2\fR, \fB8\fR and \fB16\fR when the \fIvalue\fR is larger than 0xFFFFFFFF. 

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