Compartir a través de

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

  • Artículo

Crea un objeto mediante el contexto del objeto actual.

El objeto solo tendrá contexto si su componente está registrado con COM+.

Sintaxis

HRESULT CreateInstance(
  [in]  BSTR    bstrProgID,
  [out] VARIANT *pObject
);

Parámetros

[in] bstrProgID

ProgID del tipo de objeto al que se va a crear una instancia.

[out] pObject

Referencia al nuevo objeto .

Valor devuelto

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

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

Comentarios

Cuando se crea un objeto mediante CreateInstance, el contexto del nuevo objeto se deriva de ObjectContext del objeto actual y de las propiedades declarativas del componente del nuevo objeto. El nuevo objeto siempre se ejecuta dentro de la misma actividad que el objeto que lo creó. Si el objeto actual tiene una transacción, el atributo transaction del componente del nuevo objeto determina si el nuevo objeto se ejecuta dentro del ámbito de esa transacción.

Si la configuración del atributo de transacción del componente requiere una transacción o admite transacciones, el nuevo objeto hereda la transacción del creador. Si el atributo de transacción del componente requiere una nueva transacción, COM+ inicia una nueva transacción para el nuevo objeto . Si el atributo transaction del componente no admite transacciones, el nuevo objeto no se ejecuta en ninguna transacción.

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