Função CM_Get_HW_Prof_Flags_ExA (cfgmgr32.h)

  • Artigo

[Essa função foi preterida e não deve ser usada.]

A função CM_Get_HW_Prof_Flags_Ex recupera os sinalizadores de configuração específicos do perfil de hardware para uma instância de dispositivo em um computador remoto ou em um computador local.

Sintaxe

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
  [in]           DEVINSTID_A pDeviceID,
  [in]           ULONG       ulHardwareProfile,
  [out]          PULONG      pulValue,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

Parâmetros

[in] pDeviceID

Ponteiro para uma cadeia de caracteres terminada em NULL que contém a ID da instância do dispositivo para o qual recuperar sinalizadores de configuração específicos do perfil de hardware.

[in] ulHardwareProfile

Uma variável do tipo ULONG que especifica o identificador do perfil de hardware para o qual recuperar sinalizadores de configuração. Se esse parâmetro for zero, essa função recuperará os sinalizadores de configuração para o perfil de hardware atual.

[out] pulValue

Ponteiro para uma variável fornecida pelo chamador do tipo ULONG que recebe zero ou um OR bit a bit dos seguintes sinalizadores de configuração definidos em Regstr.h:

CSCONFIGFLAG_BITS

OR bit a bit dos outros sinalizadores CSCONFIGFLAG_Xxx.

CSCONFIGFLAG_DISABLE

A instância do dispositivo está desabilitada no perfil de hardware especificado.

CSCONFIGFLAG_DO_NOT_CREATE

O perfil de hardware não dá suporte à instância de dispositivo especificada.

CSCONFIGFLAG_DO_NOT_START

O dispositivo não pode ser iniciado no perfil de hardware especificado.

[in] ulFlags

Reservado para uso interno. Deve ser definido como zero.

[in, optional] hMachine

Um identificador de computador retornado por chamada para CM_Connect_Machine ou NULL. Se esse parâmetro for definido como NULL, CM_Get_HW_Prof_Flags_Ex recuperará os sinalizadores de configuração no computador local.

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

Se a operação for bem-sucedida, CM_Get_HW_Prof_Flags retornará CR_SUCCESS. Caso contrário, a função retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para recuperar uma lista das IDs de perfil de hardware definidas atualmente em um computador remoto, chame SetupDiGetHwProfileListEx.

A funcionalidade para acessar computadores remotos foi removida nos sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Observação

O cabeçalho cfgmgr32.h define CM_Get_HW_Prof_Flags_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

   
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

Confira também

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx