Função WdfRegistryWdmGetHandle (wdfregistry.h)
[Aplica-se a KMDF e UMDF]
O método WdfRegistryWdmGetHandle retorna um identificador WDM (Modelo de Driver do Windows) para a chave do Registro que um objeto de chave de registro de estrutura especificado representa.
Sintaxe
HANDLE WdfRegistryWdmGetHandle(
[in] WDFKEY Key
);
Parâmetros
[in] Key
Um identificador para um objeto de chave do Registro que representa uma chave aberta do Registro.
Valor de retorno
WdfRegistryWdmGetHandle retorna um identificador WDM para uma chave do Registro.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
Um driver KMDF pode passar o identificador WDM retornado para as rotinas ZwXxx que aceitam um identificador WDM como entrada.
Um driver UMDF pode passar o identificador retornado para APIs que exigem um HKEY, como RegEnumKeyEx.
O identificador que o método WdfRegistryWdmGetHandle retorna é válido até que o objeto de chave do Registro seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de chave do Registro, o ponteiro será válido até que a função de retorno de chamada retorne.
Para obter mais informações sobre objetos de chave do Registro, consulte Usando o Registro em Framework-Based Drivers.
Exemplos
O exemplo de código a seguir obtém um identificador WDM para a chave do Registro que um objeto de chave de registro de estrutura especificado representa.
HANDLE hKey;
hKey = WdfRegistryWdmGetHandle(Key);