função CM_Get_HW_Prof_FlagsW (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida e não deve ser usada.]

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

Sintaxe

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsW(
  [in]  DEVINSTID_W 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 para a 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 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.

Retornar valor

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.

Comentários

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

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

Observação

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 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 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_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList