função CM_Get_HW_Prof_FlagsA (cfgmgr32.h)

Artigo
11/20/2024

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida e não deve ser usada.]

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

Sintaxe

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
  [in]  DEVINSTID_A pDeviceID,
  [in]  ULONG       ulHardwareProfile,
  [out] PULONG      pulValue,
  [in]  ULONG       ulFlags
);

Parâmetros

[in] pDeviceID

Ponteiro para uma cadeia de caracteres terminada em NULL que contém a ID da instância do dispositivo 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.

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 CR_Xxx definidos em Cfgmgr32.h.

Observações

Para recuperar uma lista de IDs de perfil de hardware definidas atualmente em um computador local, chame SetupDiGetHwProfileList.

Para recuperar sinalizadores de configuração para uma instância de dispositivo em um computador remoto, chame CM_Get_HW_Prof_Flags_Ex.

Nota

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

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList

Compartilhar via