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

.SH NAME
\fBRtlLargeIntegerToChar\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlLargeIntegerToChar
 (
  const ULONGLONG* \fIvalue_ptr\fR,
  ULONG            \fIbase\fR,
  ULONG            \fIlength\fR,
  PCHAR            \fIstr\fR
 )

.SH PARAMS
\fIvalue_ptr\fR \fB[In]\fR  Pointer to the 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
\fIlength\fR \fB[In]\fR  Length of the \fIstr\fR buffer in bytes.
.PP
\fIstr\fR \fB[Out]\fR  Destination for the converted value.
.PP

.SH DESCRIPTION
.PP
Convert an unsigned large integer to a character 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 would be larger than \fIlength\fR. \fBSTATUS_ACCESS_VIOLATION\fR, if \fIstr\fR is \fBNULL\fR. 

.SH NOTES
.PP
Instead of \fIbase\fR \fB0\fR it uses \fB10\fR as \fIbase\fR. Writes at most \fIlength\fR characters to the string \fIstr\fR. Str is \fB'\0'\fR terminated when \fIlength\fR allows it. When \fIstr\fR fits exactly in \fIlength\fR characters the \fB'\0'\fR is omitted. If \fIvalue_ptr\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 The native function does produce garbage or \fBSTATUS_BUFFER_OVERFLOW\fR for \fIbase\fR \fB2\fR, \fB8\fR and \fB16\fR when the value is larger than 0xFFFFFFFF. 

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