ISyncMgrSyncItemInfo::IsConnected-Methode (syncmgr.h)

Artikel
03/02/2024

Generiert einen Wert, der angibt, ob das Element – in der Regel ein externes Gerät – 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.

Hinweise

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

Dieser Wert ist in 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 CMyDeviceSyncItem::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

Freigeben über