função CM_Is_Version_Available (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_Is_Version_Available indica se uma versão especificada do Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) tem suporte de um computador local.

Sintaxe

CMAPI BOOL CM_Is_Version_Available(
  [in] WORD wVersion
);

Parâmetros

[in] wVersion

Identifica uma versão do gerenciador de configurações. A versão com suporte do gerenciador de configurações corresponde diretamente à versão do sistema operacional. A versão principal é especificada pelo byte de alta ordem e a versão secundária é especificada pelo byte de baixa ordem.

Por exemplo, 0x0400 especifica a versão 4.0, que tem suporte por padrão pelo Microsoft Windows 2000 e versões posteriores do Windows. 0x0501 especifica a versão 5.1, que é compatível com o Windows XP e versões posteriores do Windows.

Retornar valor

A função retornará TRUE se o computador local der suporte à versão especificada do gerenciador de configurações. Caso contrário, a função retornará FALSE.

Comentários

Use essa função para determinar se uma versão especificada do gerenciador de configurações tem suporte de um computador local. Se houver suporte para a versão especificada, todas as versões anteriores e incluindo essa versão serão compatíveis com o computador. Você também pode usar CM_Is_Version_Available_Ex para determinar se um computador local ou remoto dá suporte a uma versão específica do gerenciador de configurações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available_Ex