CM_Is_Version_Available_Ex 函数 (cfgmgr32.h)

  • 项目

[从Windows 8和Windows Server 2012开始，此函数已弃用，不应使用。]

CM_Is_Version_Available_Ex 函数指示本地计算机或远程计算机是否支持指定版本的 即插即用 (PnP) Configuration Manager DLL (Cfgmgr32.dll) 。

语法

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

参数

[in] wVersion

标识配置管理器的版本。 受支持的配置管理器版本直接对应于操作系统版本。 主版本由高阶字节指定，次要版本由低序字节指定。 例如，0x0400指定版本 4.0，Microsoft Windows NT 4.0 及更高版本的 Windows 默认支持该版本。 版本0x0501指定版本 5.1，受 Windows XP 和更高版本的 Windows 支持。

[in, optional] hMachine

提供 CM_Connect_Machine返回的计算机句柄。

注意从Windows 8和Windows Server 2012开始，不支持使用此函数访问远程计算机，因为此功能已被删除。
 

返回值

如果函数可以连接到指定的计算机并且计算机支持指定的版本，则函数返回 TRUE 。 否则，函数返回 FALSE。

注解

使用此函数可以确定本地计算机还是远程计算机支持指定版本的配置管理器。 如果支持指定版本，则计算机支持所有早期版本以及包括此版本在内的所有版本。 还可以使用 CM_Is_Version_Available 来确定本地计算机是否支持特定版本的配置管理器。

Windows 8 和 Windows Server 2012 及更高版本的操作系统中删除了访问远程计算机的功能，因此在这些版本的 Windows 上运行时，无法访问远程计算机。

要求

要求 值
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 中可用。
目标平台 桌面
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Library Cfgmgr32.lib
DLL Cfgmgr32.dll

另请参阅

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available