Funzione RtlStringFromGUID (wdm.h)
La routine RtlStringFromGUID converte un GUID specificato dal formato binario in una stringa Unicode.
Sintassi
NTSYSAPI NTSTATUS RtlStringFromGUID(
[in] REFGUID Guid,
[out] PUNICODE_STRING GuidString
);
Parametri
[in] Guid
Specifica il GUID in formato binario da convertire.
[out] GuidString
Puntatore a una variabile fornita dal chiamante in cui viene restituito un puntatore alla stringa GUID convertita. RtlStringFromGUID alloca lo spazio buffer per la stringa, che il chiamante deve liberare chiamando RtlFreeUnicodeString. La stringa restituita è nel formato {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}, incluse le parentesi graffe anteporte e aggiunte.
Valore restituito
Se la conversione ha esito positivo, RtlStringFromGUID restituisce STATUS_SUCCESS. In caso contrario, non è stata allocata alcuna risorsa di archiviazione, né è stata eseguita la conversione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente) |
| IRQL | PASSIVE_LEVEL |