IObjectContext::SetComplete-Methode (comsvcs.h)

  • Artikel

Deklariert, dass die Transaktion, in der das Objekt ausgeführt wird, committet werden kann und dass das Objekt deaktiviert werden soll, wenn es vom aktuell ausgeführten Methodenaufruf zurückgibt.

Syntax

HRESULT SetComplete();

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten. Dies kann passieren, wenn ein Objekt seinen IObjectContext-Zeiger an ein anderes Objekt übergibt und das andere Objekt SetComplete mit diesem Zeiger aufruft. Ein IObjectContext-Zeiger ist außerhalb des Kontexts des Objekts, das ihn ursprünglich abgerufen hat, ungültig.

Hinweise

Das Objekt wird automatisch deaktiviert, wenn es von der Methode zurückgibt, in der es SetComplete aufgerufen hat. Wenn das Objekt das Stammverzeichnis einer automatischen Transaktion ist, versucht COM+, die Transaktion zu committen. Wenn jedoch ein Objekt, das an der Transaktion teilgenommen hat, SetAbort aufgerufen hat oder DisableCommit aufgerufen hat und anschließend nicht EnableCommit oder SetComplete aufgerufen hat, wird die Transaktion abgebrochen.

Wenn ein Objekt seinen Zustand nicht beibehalten muss, nachdem es von einem Methodenaufruf zurückgegeben wurde, sollte es SetComplete aufrufen, damit es automatisch deaktiviert werden kann, sobald es zurückgibt und seine Ressourcen wieder abgerufen werden können.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comsvcs.h

Weitere Informationen

IObjectContext