Macro RtlIntPtrToUnicodeString (wdm.h)
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 |