Share via

ObjectContext::D isableCommit-Methode (comsvcs.h)

  • Artikel

Deklariert, dass die Transaktionsupdates des Objekts inkonsistent sind und nicht im aktuellen Zustand committet werden können.

Syntax

HRESULT DisableCommit();

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen. Die Transaktionsupdates des Objekts können erst dann committet werden, wenn das Objekt EnableCommit oder SetComplete aufruft.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten. Dies kann passieren, wenn ein Objekt seinen ObjectContext-Zeiger an ein anderes Objekt übergibt und das andere Objekt DisableCommit mit diesem Zeiger aufruft. Ein ObjectContext-Zeiger ist außerhalb des Kontexts des Objekts, das ihn ursprünglich abgerufen hat, ungültig.
CONTEXT_E_NOCONTEXT
 Dem aktuellen Objekt ist kein Kontext zugeordnet. Dies liegt wahrscheinlich daran, dass es nicht mit einer der CREATEInstance-Methoden von COM+ erstellt wurde.

Hinweise

Sie können die DisableCommit-Methode verwenden, um zu verhindern, dass eine Transaktion zwischen Methodenaufrufen in einem zustandsbehafteten Objekt vorzeitig committ. Wenn ein Objekt DisableCommit aufruft, gibt es an, dass seine Arbeit inkonsistent ist und dass es seine Arbeit erst abschließen kann, wenn es weitere Methodenaufrufe vom Client empfängt. Es gibt auch an, dass er seinen Zustand beibehalten muss, um diese Arbeit auszuführen. Dadurch wird verhindert, dass COM+ das Objekt deaktiviert und seine Ressourcen bei der Rückgabe von einem Methodenaufruf zurückgibt. Wenn ein Objekt DisableCommit aufgerufen hat und ein Client versucht, die Transaktion zu committen, bevor das Objekt EnableCommit oder SetComplete aufgerufen hat, wird die Transaktion abgebrochen.

Anforderungen

   
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

Objectcontext