ISyncMgrSyncItemInfo：：IsConnected 方法 （syncmgr.h）

產生一個值，指出項目 （通常是某種類型的外部裝置） 是否已連線。

語法

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

需求