ISyncMgrSyncItemInfo::IsConnected 方法 (syncmgr.h)

產生值,指出專案通常是某種外部裝置類型是否已連線。

Syntax

HRESULT IsConnected();

傳回值

類型: HRESULT

如果專案已連接,則傳回S_OK;否則,S_FALSE。 此方法傳回的錯誤會解譯為S_OK。

備註

如果專案已中斷連線,同步中心就不會同步處理該專案。 此外,在 UI 中會移除或停用專案可用的許多可能動作,例如同步處理。

這個值可在資料夾 UI 中作為 System.Sync.Connected (PKEY_Sync_Connected) 屬性使用。

每當呼叫 UpdateHandler 方法時,同步中心就會呼叫此方法。

範例

下列範例示範這個方法的實作,這個方法會呼叫私用類別函式來擷取連線狀態。

STDMETHODIMP CMyDeviceSyncItem::IsConnected()
{
    return (_IsConnected() ? S_OK : S_FALSE);
}

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 syncmgr.h