Compartir a través de


función CM_Is_Version_Available_Ex (cfgmgr32.h)

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso y no se debe usar.]

La función CM_Is_Version_Available_Ex indica si una versión especificada de la Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) es compatible con una máquina local o remota.

Sintaxis

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

Parámetros

[in] wVersion

Identifica una versión del administrador de configuración. La versión admitida del administrador de configuración corresponde directamente a la versión del sistema operativo. La versión principal se especifica mediante el byte de orden superior y la versión secundaria se especifica mediante el byte de orden bajo. Por ejemplo, 0x0400 especifica la versión 4.0, que es compatible de forma predeterminada con Microsoft Windows NT 4.0 y versiones posteriores de Windows. La versión 0x0501 especifica la versión 5.1, que es compatible con Windows XP y versiones posteriores de Windows.

[in, optional] hMachine

Proporciona un identificador de máquina devuelto por CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

Valor devuelto

La función devuelve TRUE si la función puede conectarse a la máquina especificada y si la máquina admite la versión especificada. De lo contrario, la función devuelve FALSE.

Comentarios

Use esta función para determinar si una versión especificada del administrador de configuración es compatible con una máquina local o remota. Si se admite la versión especificada, todas las versiones anteriores e incluidas esta versión son compatibles con la máquina. También puede usar CM_Is_Version_Available para determinar si el equipo local admite una versión específica del administrador de configuración.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib
Archivo DLL Cfgmgr32.dll

Consulte también

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available