Metodo IObjectContext::SetComplete (comsvcs.h)

  • Articolo

Dichiara che è possibile eseguire il commit della transazione in cui è in esecuzione l'oggetto e che l'oggetto deve essere disattivato quando viene restituito dalla chiamata al metodo attualmente in esecuzione.

Sintassi

HRESULT SetComplete();

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
E_UNEXPECTED
 Si è verificato un errore imprevisto. Ciò può verificarsi se un oggetto passa il puntatore IObjectContext a un altro oggetto e l'altro oggetto chiama SetComplete usando questo puntatore . Un puntatore IObjectContext non è valido al di fuori del contesto dell'oggetto che lo ha originariamente ottenuto.

Commenti

L'oggetto viene disattivato automaticamente al ritorno dal metodo in cui è denominato SetComplete. Se l'oggetto è la radice di una transazione automatica, COM+ tenta di eseguire il commit della transazione. Tuttavia, se un oggetto che partecipa alla transazione ha chiamato SetAbort o ha chiamato DisableCommit e non ha successivamente chiamato EnableCommit o SetComplete, la transazione viene interrotta.

Se non è necessario che un oggetto mantenga lo stato dopo la restituzione da una chiamata al metodo, deve chiamare SetComplete in modo che possa essere disattivato automaticamente non appena viene restituito e che le relative risorse possano essere recuperate.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione comsvcs.h

Vedi anche

IObjectContext