função CM_Get_Version_Ex (cfgmgr32.h)

  • Artigo

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

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

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

Confira também

CM_Get_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex