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

Confira também

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE