IReconcileInitiator::SetAbortCallback-Methode (reconcil.h)

  • Artikel

Legt das -Objekt fest, über das der Initiator eine Abstimmung asynchron beenden kann. Ein Aktenkoffer-Abgleich legt dieses Objekt in der Regel für Abstimmungen fest, die langwierig sind oder eine Benutzerinteraktion erfordern.

Syntax

HRESULT SetAbortCallback(
  IUnknown *punkForAbort
);

Parameter

punkForAbort

Typ: IUnknown*

Die Adresse der IUnknown-Schnittstelle für das Objekt. Der Initiator signalisiert eine Anforderung zum Beenden der Abstimmung mithilfe der IUnknown::Release-Methode , um das Objekt freizugeben. Dieser Parameter kann NULL sein, um den Initiator anzuweisen, das zuvor angegebene Objekt zu entfernen.

Rückgabewert

Typ: HRESULT

Gibt den S_OK Wert zurück, wenn erfolgreich, oder andernfalls einen der folgenden Fehlerwerte.

Rückgabecode Beschreibung
REC_E_NOCALLBACK
 Der Initiator unterstützt das Beenden von Abstimmungsvorgängen nicht und hält das angegebene Objekt nicht bereit.
E_UNEXPECTED
 Unbekannter Fehler.

Bemerkungen

Der Initiator kann das Objekt annehmen oder ablehnen. Wenn der Initiator das Objekt akzeptiert, muss der Aktenkoffer-Abgleich das Objekt entfernen, indem er diese Methode mit einem NULL-Parameter aufruft, wenn der Abgleich abgeschlossen ist. Da der Abgleich das Objekt nach Abschluss des Abgleichs entfernt, kann es vorkommen, dass der Initiator das Objekt nach Abschluss des Abgleichs freigibt. In solchen Fällen ignoriert der Abgleich die Beendigungsanforderung.

Wenn der Abgleich beendet wird, muss die Reconcile-Methode entweder den REC_E_ABORTED- oder REC_E_NOTCOMPLETE-Wert zurückgeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile reconcil.h
DLL Shell32.dll (Version 4.0 oder höher)

Weitere Informationen

IReconcileInitiator