CoGetObjectContext-Funktion (combaseapi.h)
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 |
---|---|
|
Der Objektkontext wurde erfolgreich abgerufen. |
|
Die angeforderte Schnittstelle war nicht verfügbar. |
|
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 |