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 |