Fonction RtlInt64ToUnicodeString (wdm.h)

  • Article

La routine RtlInt64ToUnicodeString convertit une valeur entière 64 bits non signée spécifiée en chaîne Unicode qui représente la valeur dans une base spécifiée.

Syntaxe

NTSYSAPI NTSTATUS RtlInt64ToUnicodeString(
  [in]           ULONGLONG       Value,
  [in, optional] ULONG           Base,
  [in, out]      PUNICODE_STRING String
);

Paramètres

[in] Value

Spécifie la valeur ULONGLONG à convertir.

[in, optional] Base

Spécifie la base à utiliser lors de la conversion d’une valeur en chaîne. Les valeurs possibles sont les suivantes :

Valeur Base
16 Valeur hexadécimale
8 Octal
2 Binary
0 ou 10 Decimal

[in, out] String

Pointeur vers la structure UNICODE_STRING qui reçoit la représentation sous forme de chaîne de Value. La mémoire tampon spécifiée par la mémoire tampon de string doit être suffisamment grande pour contenir le résultat.

Valeur retournée

RtlInt64ToUnicodeString retourne une valeur NTSTATUS. Les valeurs de retour possibles sont les suivantes :

Code de retour Description
STATUS_SUCCESS
 La routine a correctement converti value en chaîne Unicode.
STATUS_BUFFER_OVERFLOW
 La valeur est trop grande pour être convertie ou la structure UNICODE_STRING est trop petite pour contenir le résultat.
STATUS_INVALID_PARAMETER
 La base de code spécifiée n’est pas valide. Les seules valeurs valides sont 0, 2, 8, 10 et 16.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING