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 |