Macro RtlIntPtrToUnicodeString (wdm.h)

  • Article

La routine RtlIntPtrToUnicodeString convertit une valeur ULONG_PTR spécifiée en chaîne Unicode qui représente la valeur dans une base spécifiée.

Syntaxe

void RtlIntPtrToUnicodeString(
  [in]            Value,
  [in, optional]  Base,
  [in, out]       String
);

Paramètres

[in] Value

Spécifie la valeur ULONG_PTR à convertir.

[in, optional] Base

Spécifie la base à utiliser lors de la conversion de Value 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 de retour

None

Remarques

RtlIntPtrToUnicodeString 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 Desktop (Expérience utilisateur)
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

RtlIntegerToUnicodeString

RtlUnicodeStringToInteger

UNICODE_STRING