função CM_Open_Device_Interface_Key_ExA (cfgmgr32.h)

Artigo
11/20/2024

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Open_Device_Interface_Key.]

A função CM_Open_Device_Interface_Key_ExA abre a subchave do Registro usada por aplicativos e drivers para armazenar informações específicas de uma interface do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExA(
  [in]           LPCSTR         pszDeviceInterface,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkDeviceInterface,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

Parâmetros

[in] pszDeviceInterface

Ponteiro para uma cadeia de caracteres que identifica a instância da interface do dispositivo para a qual abrir a subchave do Registro.

[in] samDesired

O acesso de segurança do Registro solicitado à subchave do Registro.

[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] phkDeviceInterface

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

[in] ulFlags

Reservado. Deve ser definido como zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

Observação Não há suporte para o uso dessa função para acessar computadores remotos a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.

Valor de retorno

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.

Observações

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

Nota

O cabeçalho cfgmgr32.h define CM_Open_Device_Interface_Key_Ex como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Microsoft Windows 10 e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
biblioteca	Cfgmgr32.lib

Consulte também

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

Compartilhar via