CoGetObjectContext-Funktion (combaseapi.h)

Artikel
02/28/2024

Gibt den Kontext für das aktuelle Objekt zurück.

Syntax

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

Parameter

[in] riid

Ein Verweis auf die ID einer Schnittstelle, die für das Kontextobjekt implementiert ist.

Für Objekte, die in COM-Anwendungen ausgeführt werden, sind IID_IComThreadingInfo, IID_IContext und IID_IContextCallback verfügbar.

Für Objekte, die in COM+-Anwendungen ausgeführt werden, sind IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo und IID_IContextState verfügbar.

[out] ppv

Die Adresse eines Zeigers auf die Schnittstelle, die von riid für das Kontextobjekt angegeben wird.

Rückgabewert

Diese Funktion kann die standardmäßigen Rückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Objektkontext wurde erfolgreich abgerufen.
E_NOINTERFACE	Die angeforderte Schnittstelle war nicht verfügbar.
CO_E_NOTINITIALIZED	Bevor diese Funktion aufgerufen werden kann, muss die CoInitializeEx-Funktion im aktuellen Thread aufgerufen werden.

Hinweise

CoGetObjectContext ruft den Kontext für das Objekt ab, aus dem es aufgerufen wird, und gibt einen Zeiger auf eine Schnittstelle zurück, die zum Bearbeiten von Kontexteigenschaften verwendet werden kann. Kontexteigenschaften werden verwendet, um Dienste für konfigurierte Komponenten bereitzustellen, die in COM+-Anwendungen ausgeführt werden.

Für Komponenten, die in COM-Anwendungen ausgeführt werden, werden die folgenden Schnittstellen für den Zugriff auf Kontexteigenschaften unterstützt: IComThreadingInfo, IContext und IContextCallback.

Für Komponenten, die in COM+-Anwendungen ausgeführt werden, werden die folgenden Schnittstellen für den Zugriff auf Kontexteigenschaften unterstützt: IObjectContext, IObjectContextActivity, IObjectContextInfo und IContextState.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	combaseapi.h (include Objbase.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

Kontexte und Threadingmodelle

Freigeben über