ISyncMgrSyncItem::Enable-Methode (syncmgr.h)

Artikel
03/02/2024

Aktiviert oder deaktiviert das Synchronisierungselement.

Syntax

HRESULT Enable(
  [in] BOOL fEnable
);

Parameter

[in] fEnable

Typ: BOOL

TRUE , um zu aktivieren; Zu deaktivierende FALSE .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Sync Center ruft diese Methode in den folgenden Szenarien auf.

Wenn der Benutzer das Element im Ordner des Handlers auswählt und den Task Aktivieren startet, jedoch nur, wenn das Element das SYNCMGR_IPM_PREVENT_ENABLE-Flag nicht festgelegt hat. Wenn der Handler das SYNCMGR_OBJECTID_QueryBeforeEnable-Objekt unterstützt, wird diese Methode nur aufgerufen, wenn der Ui-Vorgang erfolgreich war.
Wenn der Benutzer das Element im Ordner des Handlers auswählt und den Task Deaktivieren startet, jedoch nur, wenn das Element das SYNCMGR_IPM_PREVENT_DISABLE-Flag nicht festgelegt hat. Wenn der Handler das SYNCMGR_OBJECTID_QueryBeforeDisable-Objekt unterstützt, wird diese Methode nur aufgerufen, wenn der Ui-Vorgang erfolgreich war.

Wenn der Handler keine Aktionen ausführen muss, wenn er aktiviert wird, kann er entweder S_OK oder E_NOTIMPL zurückgeben, wie im folgenden Beispiel gezeigt.

Beispiele

Das folgende Beispiel zeigt eine einfache Implementierung dieser Methode.

STDMETHODIMP CMyDeviceSyncItem::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

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