Função CM_Open_Device_Interface_Key_ExA (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e 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 que é 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 êxito.

[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.

Nota 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.
 

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.

Observação

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 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 10 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_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey