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指定預設由 Microsoft Windows NT 4.0 和更新版本的 Windows 支援 4.0 版。 版本0x0501指定 Windows XP 和更新版本的 Windows 支援 5.1 版。

[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)
程式庫 Cfgmgr32.lib
Dll Cfgmgr32.dll

另請參閱

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available