função CM_Open_Device_Interface_KeyA (cfgmgr32.h)

Artigo
11/20/2024

A função CM_Open_Device_Interface_Key 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_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

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.

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 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 Vista e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
biblioteca	Cfgmgr32.lib

Consulte também

SetupDiOpenDeviceInterfaceRegKey

Compartilhar via