função CM_Get_HW_Prof_Flags_ExA (cfgmgr32.h)

Artigo
11/20/2024

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

A função CM_Get_HW_Prof_Flags_Ex recupera o perfil de hardware sinalizadores de configuração específicos 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 por 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 do 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 de 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 estiver definido como NULL, CM_Get_HW_Prof_Flags_Ex recuperará os sinalizadores de configuração no computador local.

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

Observações

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 ao executar essas versões do Windows.

Nota

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 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 2000 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_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx

Compartilhar via