função CM_Get_Version_Ex (cfgmgr32.h)
[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_Version_Ex retorna a versão 4.0 da DLL de Configuration Manager plug and play (PnP) (Cfgmgr32.dll) para um computador local ou remoto.
Sintaxe
CMAPI WORD CM_Get_Version_Ex(
[in, optional] HMACHINE hMachine
);
Parâmetros
[in, optional] hMachine
Fornece um identificador de computador retornado por CM_Connect_Machine.
Valor retornado
Se a função for bem-sucedida, ela retornará o número de revisão principal no byte de ordem alta e o número de revisão secundária no byte de baixa ordem. A versão 4.0 é retornada como 0x0400. Por padrão, a versão 4.0 tem suporte do Microsoft Windows 2000 e versões posteriores do Windows. Se ocorrer um erro interno, a função retornará 0x0000. Chame GetLastError para obter o código de erro para a falha.
Comentários
Essa função retorna a versão 4.0 do configuration manager para garantir a compatibilidade com a versão 4.0 e todas as versões posteriores do configuration manager e garantir a compatibilidade com todos os aplicativos que exigem a versão 4.0 do gerenciador de configurações.
Para determinar se uma versão específica do gerenciador de configurações está disponível em um computador, use CM_Is_Version_Available ou CM_Is_Version_Available_Ex.
A funcionalidade para acessar computadores remotos foi removida nos 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
| 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 |
| DLL | Cfgmgr32.dll |