ObjectContext::D isableCommit-Methode (comsvcs.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. Die Transaktionsupdates des Objekts können erst dann committet werden, wenn das Objekt EnableCommit oder SetComplete aufruft. |
|
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. |
|
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 |