ISyncMgrSyncItemInfo::IsConnected-Methode (syncmgr.h)

Generiert einen Wert, der angibt, ob das Element – in der Regel ein externer Gerätetyp – verbunden ist.

Syntax

HRESULT IsConnected();

Rückgabewert

Typ: HRESULT-

Gibt S_OK zurück, wenn das Element verbunden ist; andernfalls S_FALSE. Ein von dieser Methode zurückgegebener Fehler wird als S_OK interpretiert.

Bemerkungen

Wenn ein Element getrennt ist, wird es nicht vom Sync Center synchronisiert. Außerdem werden viele der möglichen Aktionen, die für ein Element verfügbar sind , z. B. "Synchronisieren", in der Benutzeroberfläche entfernt oder deaktiviert.

Dieser Wert ist in der Ordnerbenutzeroberfläche als System.Sync.Connected (PKEY_Sync_Connected)-Eigenschaft verfügbar.

Sync Center ruft diese Methode immer dann auf, wenn die UpdateHandler-Methode aufgerufen wird.

Examples

Das folgende Beispiel zeigt eine Implementierung dieser Methode, die eine private Klassenfunktion aufruft, um den verbundenen Zustand abzurufen.

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

Anforderungen