Fonction RtlStringFromGUID (wdm.h)
La routine RtlStringFromGUID convertit un GUID donné au format binaire en chaîne Unicode.
Syntaxe
NTSYSAPI NTSTATUS RtlStringFromGUID(
[in] REFGUID Guid,
[out] PUNICODE_STRING GuidString
);
Paramètres
[in] Guid
Spécifie le GUID au format binaire à convertir.
[out] GuidString
Pointeur vers une variable fournie par l’appelant dans laquelle un pointeur vers la chaîne GUID convertie est retourné. RtlStringFromGUID alloue l’espace tampon pour la chaîne, que l’appelant doit libérer en appelant RtlFreeUnicodeString. La chaîne retournée se présente sous la forme {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
, y compris les accolades et les accolades.
Valeur retournée
Si la conversion réussit, RtlStringFromGUID retourne STATUS_SUCCESS. Sinon, aucun stockage n’a été alloué et la conversion n’a pas été effectuée.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 2000. |
Plateforme cible | Universal |
En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur) |
IRQL | PASSIVE_LEVEL |