Método ObjectContext::SetComplete (comsvcs.h)

  • Artículo

Declara que la transacción en la que se está ejecutando el objeto se puede confirmar y que el objeto se debe desactivar al devolver.

Sintaxis

HRESULT SetComplete();

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_FAIL, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_UNEXPECTED
 Se produjo un error inesperado. Esto puede ocurrir si un objeto pasa su puntero ObjectContext a otro objeto y el otro objeto llama a SetComplete mediante este puntero. Un puntero ObjectContext no es válido fuera del contexto del objeto que lo obtuvo originalmente.

Comentarios

El objeto se desactiva automáticamente al devolver desde el método en el que llamó a SetComplete. Si el objeto es la raíz de una transacción automática, COM+ intenta confirmar la transacción. Sin embargo, si algún objeto que participaba en la transacción ha llamado a SetAbort, o ha llamado a DisableCommit y no ha llamado posteriormente a EnableCommit o SetComplete, se anula la transacción.

Si un objeto no necesita mantener su estado después de que vuelva desde una llamada al método, debe llamar a SetComplete para que se pueda desactivar automáticamente tan pronto como se devuelva y se puedan reclamar sus recursos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comsvcs.h

Consulte también

Objectcontext