ObjectContext::SetComplete-Methode (comsvcs.h)
Deklariert, dass die Transaktion, in der das Objekt ausgeführt wird, committet werden kann und dass das Objekt bei der Rückgabe deaktiviert werden soll.
Syntax
HRESULT SetComplete();
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. |
|
Ein unerwarteter Fehler ist aufgetreten. Dies kann passieren, wenn ein Objekt seinen ObjectContext-Zeiger an ein anderes Objekt übergibt und das andere Objekt SetComplete mit diesem Zeiger aufruft. Ein ObjectContext-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 |