Função RtlStringFromGUID (wdm.h)
A rotina RtlStringFromGUID converte um determinado GUID do formato binário em uma cadeia de caracteres Unicode.
Sintaxe
NTSYSAPI NTSTATUS RtlStringFromGUID(
[in] REFGUID Guid,
[out] PUNICODE_STRING GuidString
);
Parâmetros
[in] Guid
Especifica o GUID de formato binário a ser convertido.
[out] GuidString
Ponteiro para uma variável fornecida pelo chamador na qual um ponteiro para a cadeia de caracteres GUID convertida é retornado. RtlStringFromGUID aloca o espaço de buffer para a cadeia de caracteres, que o chamador deve liberar chamando RtlFreeUnicodeString. A cadeia de caracteres retornada está no formato {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}, incluindo as chaves pré-acrescentadas e acrescentadas.
Retornar valor
Se a conversão for bem-sucedida, RtlStringFromGUID retornará STATUS_SUCCESS. Caso contrário, nenhum armazenamento foi alocado nem a conversão foi executada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário) |
| IRQL | PASSIVE_LEVEL |