Função RtlStringFromGUID (wdm.h)

Artigo
02/27/2024

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

Confira também

RtlGUIDFromString