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