ISyncMgrHandlerInfo::IsConnected-Methode (syncmgr.h)

  • Artikel

Ruft einen Wert ab, der angibt, ob der Handler – in der Regel ein externes Gerät – verbunden ist.

Syntax

HRESULT IsConnected();

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn ein Handler getrennt wird, werden weder er noch eines seiner Elemente vom Synchronisierungscenter synchronisiert. Außerdem werden viele der für einen Handler verfügbaren Aktionen – z. B. Synchronisierung – auf der Benutzeroberfläche des Sync Center-Ordners entfernt oder deaktiviert.

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

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

Beispiele

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

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile syncmgr.h