ISyncMgrHandlerInfo：：IsConnected 方法 （syncmgr.h）

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

語法

HRESULT IsConnected();

返回值

類型： HRESULT

如果處理常式已連線，則傳回S_OK;否則，S_FALSE。 這個方法傳回的錯誤會解譯為S_OK。

備註

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

此值可在資料夾 UI 中作為 System.Sync.Connected （PKEY_Sync_Connected） 屬性使用。

每當呼叫 UpdateHandler 方法時，同步處理中心都會呼叫這個方法。

範例

下列範例顯示此方法的實作，該方法會呼叫私人類別函式來擷取連線狀態。

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

需求