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

.SH NAME
\fBRtlIntegerToChar\fR (NTDLL.@)
.SH SYNOPSIS
NTSTATUS RtlIntegerToChar
 (
  ULONG \fIvalue\fR,
  ULONG \fIbase\fR,
  ULONG \fIlength\fR,
  PCHAR \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
\fIlength\fR \fB[In]\fR  Length of the \fIstr\fR buffer in bytes.
.PP
\fIstr\fR \fB[Out]\fR  Destination for the converted \fIvalue\fR.
.PP

.SH DESCRIPTION
.PP
Converts an unsigned 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. 

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