Compartilhar via


função CM_Is_Version_Available_Ex (cfgmgr32.h)

[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_Ex indica se uma versão especificada do Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) é compatível com um computador local ou remoto.

Sintaxe

CMAPI BOOL CM_Is_Version_Available_Ex(
  [in]           WORD     wVersion,
  [in, optional] HMACHINE hMachine
);

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 NT 4.0 e versões posteriores do Windows. A versão 0x0501 especifica a versão 5.1, que é compatível com o Windows XP e versões posteriores do Windows.

[in, optional] hMachine

Fornece um identificador de computador retornado por CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

Retornar valor

A função retornará TRUE se a função puder se conectar ao computador especificado e se o computador der suporte à versão especificada. Caso contrário, a função retornará FALSE.

Comentários

Use essa função para determinar se há suporte para uma versão especificada do gerenciador de configurações por um computador local ou remoto. 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 para determinar se o computador local dá suporte a uma versão específica do gerenciador de configurações.

A funcionalidade para acessar computadores remotos foi removida em 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.

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_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available