Fonction RtlIntegerToUnicodeString (wdm.h)

  • Article

La routine RtlIntegerToUnicodeString convertit une valeur entière non signée en chaîne terminée par null d’un ou plusieurs caractères Unicode dans la base spécifiée.

Syntaxe

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

Paramètres

[in] Value

Spécifie la valeur ULONG à 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 une 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

RtlIntegerToUnicodeString 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 (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL PASSIVE_LEVEL

Voir aussi

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING