Função CM_Open_Device_Interface_KeyW (cfgmgr32.h)

  • Artigo

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_KeyW(
  [in]  LPCWSTR        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 êxito.

[in] ulFlags

Reservado. Deve ser definido como zero.

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

Confira também

SetupDiOpenDeviceInterfaceRegKey