Fonction RtlStringFromGUID (wdm.h)

  • Article

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

Voir aussi

RtlGUIDFromString