Export (0) Print
Expand All
Expand Minimize

RtlInt64ToUnicodeString routine

The RtlInt64ToUnicodeString routine converts a specified unsigned 64-bit integer value to a Unicode string that represents the value in a specified base.

Syntax


NTSTATUS RtlInt64ToUnicodeString(
  _In_      ULONGLONG Value,
  _In_opt_  ULONG Base,
  _Inout_   PUNICODE_STRING String
);

Parameters

Value [in]

Specifies the ULONGLONG value to convert.

Base [in, optional]

Specifies the base to use when converting Value to a string. The possible values are:

ValueBase

16

Hexadecimal

8

Octal

2

Binary

0 or 10

Decimal

 

String [in, out]

Pointer to the UNICODE_STRING structure that receives the string representation of Value. The buffer specified by the Buffer of String must be large enough to hold the result.

Return value

RtlInt64ToUnicodeString returns an NTSTATUS value. Possible return values include :

Return codeDescription
STATUS_SUCCESS

The routine successfully converted Value to a Unicode string.

STATUS_BUFFER_OVERFLOW

Value is too large to convert, or the UNICODE_STRING structure is too small to hold the result.

STATUS_INVALID_PARAMETER

The specified code base is not valid. The only valid values are 0, 2, 8, 10, and 16.

 

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

See also

RtlAppendUnicodeStringToString
RtlUnicodeStringToInteger
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft