Método ObjectControl::Activate (comsvcs.h)

Permite que un objeto COM+ realice una inicialización específica del contexto cada vez que se activa.

El entorno en tiempo de ejecución de COM+ llama a este método antes de llamar a cualquier otro método en el objeto .

Sintaxis

HRESULT Activate();

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL y S_OK.

Comentarios

Cada vez que un cliente llama a un objeto COM+ que aún no está activo, el entorno en tiempo de ejecución de COM+ activa automáticamente el objeto. Esto se denomina Activación Just-In-Time. Para los componentes que admiten ObjectControl como interfaz, COM+ invoca el método Activate del objeto antes de pasar la llamada al método del cliente al objeto.

Los procedimientos de inicialización específicos del contexto deben implementarse en el método Activate para los objetos que exponen ObjectControl.

Por ejemplo, puede usar el método Activate para obtener una referencia al contexto de un objeto y almacenarla en una variable miembro. A continuación, el contexto del objeto está disponible para cualquier método que lo requiera y no tiene que adquirir uno nuevo cada vez que quiera usarlo. Después de tener una referencia al contexto del objeto, puede usar los métodos ObjectContext para comprobar si la seguridad está habilitada, si el objeto se está ejecutando en una transacción o si el autor de la llamada está en un rol determinado.

Si va a habilitar el reciclaje de objetos (implementando el método CanBePooled para consultar el objeto), el método Activate debe ser capaz de controlar objetos recién creados, así como objetos reciclados. Cuando el método Activate devuelve, no debe haber ninguna diferencia distintiva entre un nuevo objeto y uno reciclado.

COM+ prohíbe expresamente llamar a un objeto que expone ObjectControl antes de llamar al método Activate (cuando está en su constructor). Esta llamada provocaría un error de RPC_E_DISCONNECTED. Por ejemplo, si un objeto pasa una referencia a sí misma mientras está en su constructor y, a continuación, la referencia vuelve a llamar a ese objeto antes de la llamada a Activate, se devuelve el error desconectado.

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

ObjectControl