ObjectContext::CreateInstance-Methode (comsvcs.h)

Artikel
02/24/2024

Erstellt ein Objekt unter Verwendung des Kontexts des aktuellen Objekts.

Das Objekt verfügt nur über Kontext, wenn seine Komponente bei COM+ registriert ist.

Syntax

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

Parameter

[in] bstrProgID

Die ProgID des Typs des zu instanziierenden Objekts.

[out] pObject

Ein Verweis auf das neue Objekt.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten. Dies kann passieren, wenn ein Objekt seinen ObjectContext-Zeiger an ein anderes Objekt übergibt und das andere Objekt CreateInstance mit diesem Zeiger aufruft. Ein ObjectContext-Zeiger ist außerhalb des Kontexts des Objekts, das ihn ursprünglich abgerufen hat, ungültig.

Hinweise

Wenn Sie ein Objekt mit CreateInstance erstellen, wird der Kontext des neuen Objekts vom ObjectContext des aktuellen Objekts und den deklarativen Eigenschaften der Komponente des neuen Objekts abgeleitet. Das neue Objekt wird immer innerhalb derselben Aktivität ausgeführt wie das Objekt, von dem es erstellt wurde. Wenn das aktuelle Objekt über eine Transaktion verfügt, bestimmt das Transaktionsattribute der Komponente des neuen Objekts, ob das neue Objekt innerhalb des Bereichs dieser Transaktion ausgeführt wird.

Wenn die Transaktionsattributeeinstellung der Komponente entweder eine Transaktion erfordert oder Transaktionen unterstützt, erbt das neue Objekt die Transaktion des Erstellers. Wenn das Transaktionsattribute der Komponente eine neue Transaktion erfordert, initiiert COM+ eine neue Transaktion für das neue Objekt. Wenn das Transaktionsattribute der Komponente keine Transaktionen unterstützt, wird das neue Objekt unter keiner Transaktion ausgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comsvcs.h

Weitere Informationen

Objectcontext

Share via