CoGetObjectContext-Funktion (combaseapi.h)

  • Artikel

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