CM_Is_Dock_Station_Present_Ex函式 (cfgmgr32.h)

[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代。請改用 CM_Is_Dock_Station_Present 。]

CM_Is_Dock_Station_Present_Ex函式會識別停駐站是否存在於本機或遠端計算機。

語法

CMAPI CONFIGRET CM_Is_Dock_Station_Present_Ex(
  [out]          PBOOL    pbPresent,
  [in, optional] HMACHINE hMachine
);

[out] pbPresent

布爾值的指標，指出停駐站是否存在於本機計算機中。如果停駐站存在，函式會將 *pbPresent 設定為 TRUE 。如果函式無法連線到指定的計算機或停駐站不存在，函式會將 *pbPresent 設定為 FALSE 。

[in, optional] hMachine

提供由 CM_Connect_Machine 傳回的計算機句柄。

注意從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為已移除此功能。

如果作業成功，函式會傳回CR_SUCCESS。否則，函式會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

使用此函式來判斷停駐站是否存在於本機或遠端計算機。您也可以搭配停駐站使用下列相關函式：

存取遠端電腦的功能已在 Windows 8 和 Windows Server 2012 及更新版本的作業系統中移除，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。

需求	值
最低支援的用戶端	可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台	桌面
標頭	cfgmgr32.h (包含 Cfgmgr32.h)
程式庫	Cfgmgr32.lib
Dll	Cfgmgr32.dll