Função IoOpenDriverRegistryKey (wdm.h)

A rotina IoOpenDriverRegistryKey retorna um identificador para uma chave do Registro específica do driver para um driver específico.

Sintaxe

NTSTATUS IoOpenDriverRegistryKey(
  [in]  PDRIVER_OBJECT     DriverObject,
  [in]  DRIVER_REGKEY_TYPE RegKeyType,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  ULONG              Flags,
  [out] PHANDLE            DriverRegKey
);

Parâmetros

[in] DriverObject

Um ponteiro para uma estrutura DRIVER_OBJECT . Essa estrutura deve ser o objeto driver do driver de chamada.

[in] RegKeyType

Uma enumeração do tipo DRIVER_REGKEY_TYPE que indica o tipo da chave do Registro solicitada.

[in] DesiredAccess

Especifica o valor ACCESS_MASK que representa os direitos de acesso necessários para a chave. Consulte ZwCreateKey para obter uma descrição de cada KEY_XXX direito de acesso.

[in] Flags

Defina como zero.

[out] DriverRegKey

Um ponteiro para a variável HANDLE que, no retorno bem-sucedido, contém um identificador para a chave do Registro solicitada.

Retornar valor

IoOpenDriverRegistryKey retornará STATUS_SUCCESS se a chamada tiver aberto com êxito um identificador para a chave do Registro solicitada.

Comentários

O driver deve chamar ZwClose para fechar o identificador retornado dessa rotina quando o acesso não for mais necessário.

As chaves do Registro abertas por essa rotina não sãovolatile.

Para provisionar chaves e valores na chave do Registro DriverRegKeyParameters imutável, use uma diretiva AddReg de uma seção service-install para fazer referência a uma seção add-registry-section que contém entradas com uma raiz reg de HKR e uma subchave de Parameters.

Os chamadores de IoOpenDriverRegistryKey devem estar em execução em IRQL = PASSIVE_LEVEL no contexto de um thread do sistema.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803
Cabeçalho	wdm.h (include wdm.h, ntddk.h ou ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE