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);
}