ISyncMgrUIOperation::Run-Methode (syncmgr.h)

Artikel
08/26/2023

Führt die tatsächliche Anzeige der Benutzeroberfläche für einen Handler oder ein Synchronisierungselement aus, wenn dies vom Synchronisierungscenter angefordert wird.

Syntax

HRESULT Run(
  [in] HWND hwndOwner
);

Parameter

[in] hwndOwner

Typ: HWND

Ein Handle für das Fenster, das zum Anzeigen der Benutzeroberfläche verwendet wird.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Gibt S_FALSE oder einen anderen Fehlercode zurück, wenn diese Methode aufgerufen wird, um einen Vorgang zu bestätigen, z. B. das Aktivieren eines Handlers oder das Deaktivieren eines Synchronisierungselements, aber dieser Vorgang sollte nicht ausgeführt werden.

Hinweise

Es wird erwartet, dass der Handler selbst, nicht die Benutzeroberfläche, die ISyncMgrControl-Schnittstelle verwendet, um das Synchronisierungscenter über Änderungen an seinem Zustand zu benachrichtigen, die durch entscheidungen des Benutzers auf der Benutzeroberfläche auftreten.

Beispiele

Das folgende Beispiel zeigt die Gliederung einer Implementierung dieser Methode. In diesem Fall wird die Implementierung zurückgegeben, wenn GetObject mit der SYNCMGR_OBJECTID_QueryBeforeDelete Objekt-ID aufgerufen wird.

STDMETHODIMP CQueryBeforeDelete::Run(__in HWND hwndOwner)
{
    HRESULT hr = S_OK;

    // Display a dialog confirming that the user wants to delete the item.

    return hr;
}

Anforderungen


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

Share via