Função SetupDiOpenClassRegKeyExA (setupapi.h)

  • Artigo

A função SetupDiOpenClassRegKeyEx abre a chave do Registro da classe de instalação do dispositivo , a chave do Registro da classe de interface do dispositivo ou a subchave de uma classe específica. Essa função abre a chave especificada no computador local ou em um computador remoto.

Sintaxe

WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Parâmetros

[in, optional] ClassGuid

Um ponteiro para o GUID da classe cuja chave do Registro deve ser aberta. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, a raiz da árvore de classe (HKLM\SYSTEM\CurrentControlSet\Control\Class) será aberta.

[in] samDesired

O acesso de segurança do Registro para a chave a ser aberta. Para obter informações sobre valores de acesso de segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.

[in] Flags

O tipo de chave do Registro a ser aberta, que é especificado por um dos seguintes:

DIOCR_INSTALLER

Abra uma chave de classe de instalação. Se ClassGuid for NULL, abra a chave raiz do branch do instalador de classe.

DIOCR_INTERFACE

Abra uma chave de classe de interface. Se ClassGuid for NULL, abra a chave raiz do branch da classe de interface.

[in, optional] MachineName

Opcionalmente, aponta para uma cadeia de caracteres que contém o nome de um computador remoto no qual abrir a chave especificada.

Cuidado

Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.

Reserved

Reservado. Deve ser NULL.

Retornar valor

SetupDiOpenClassRegKeyEx retorna um identificador para uma chave do Registro aberta em que as informações sobre essa classe de instalação podem ser armazenadas/recuperadas.

Se a função falhar, ela retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Dependendo do valor passado no parâmetro samDesired , pode ser necessário que o chamador dessa função seja membro do grupo Administradores.

SetupDiOpenClassRegKeyEx não criará uma chave do Registro se ela ainda não existir.

Os chamadores dessa função devem fechar o identificador retornado dessa função chamando RegCloseKey.

Observação

O cabeçalho setupapi.h define SetupDiOpenClassRegKeyEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib

Confira também

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey