Compartilhar via


função CM_Open_Class_KeyA (cfgmgr32.h)

A função CM_Open_Class_Key abre a chave do Registro da classe de instalação do dispositivo, a chave do Registro da classe de interface do dispositivo ou uma subchave específica de uma classe.

Sintaxe

CMAPI CONFIGRET CM_Open_Class_KeyA(
  [in, optional] LPGUID         ClassGuid,
  [in, optional] LPCSTR         pszClassName,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkClass,
  [in]           ULONG          ulFlags
);

Parâmetros

[in, optional] ClassGuid

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 será aberta.

[in, optional] pszClassName

Reservado. Deve ser definido como NULL.

[in] samDesired

O acesso de segurança do Registro para a chave a ser aberta.

[in] Disposition

Especifica como a chave do Registro deve ser aberta. Pode ser um dos seguintes valores:

RegDisposition_OpenAlways

Abra a chave se ela existir. Caso contrário, crie a chave.

RegDisposition_OpenExisting

Abra a chave somente se ela existir.

[out] phkClass

Ponteiro para um HKEY que receberá a chave aberta após o sucesso.

[in] ulFlags

Abra sinalizadores de chave de classe:

CM_OPEN_CLASS_KEY_INSTALLER

A chave a ser aberta é para uma classe de configuração de dispositivo.

CM_OPEN_CLASS_KEY_INTERFACE

A chave a ser aberta é para uma classe de interface do dispositivo.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Feche o identificador retornado dessa função chamando RegCloseKey.

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 cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib

Confira também

CM_Delete_Class_Key
SetupDiOpenClassRegKeyEx