ISyncMgrHandlerInfo：：IsConnected 方法 (syncmgr.h)

取得值，指出處理程式是否通常是某種外部裝置類型已連線。

Syntax

HRESULT IsConnected();

類型： HRESULT

如果處理程式已連接，則傳回S_OK;否則，S_FALSE。此方法傳回的錯誤會解譯為S_OK。

如果處理程式已中斷連線，則同步中心不會同步處理處理程式及其任何專案。此外，處理程式可用的許多可能動作，例如 Sync，都會在同步中心資料夾 UI 中移除或停用。

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

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

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

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