Metodo ObjectContext::SetComplete (comsvcs.h)

Dichiara che è possibile eseguire il commit della transazione in cui è in esecuzione l'oggetto e che l'oggetto deve essere disattivato al ritorno.

Sintassi

HRESULT SetComplete();

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_FAIL, nonché 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 ObjectContext a un altro oggetto e l'altro oggetto chiama SetComplete usando questo puntatore . Un puntatore ObjectContext 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

Objectcontext