CoGetObjectContext 函式 (combaseapi.h)

傳回目前對象的內容。

語法

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

[in] riid

在內容對象上實作之介面標識碼的參考。

對於在 COM 應用程式內執行的物件，可以使用IID_IComThreadingInfo、IID_IContext和IID_IContextCallback。

對於在 COM+ 應用程式內執行的物件，可以使用 IID_IObjectContext、IID_IObjectContextActivity IID_IObjectContextInfo 和 IID_IContextState。

[out] ppv

內容物件上 riid 所指定介面的指標位址。

此函式可以傳回標準傳回值E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

傳回碼	描述
S_OK	已成功擷取對象內容。
E_NOINTERFACE	要求的介面無法使用。
CO_E_NOTINITIALIZED	必須先在目前線程上呼叫 CoInitializeEx 函式，才能呼叫此函式。

CoGetObjectContext 會擷取其呼叫對象的內容，並傳回可用來操作內容屬性之介面的指標。內容屬性可用來提供服務，以設定在 COM+ 應用程式內執行的元件。

對於在 COM 應用程式內執行的元件，支援下列介面來存取內容屬性：IComThreadingInfo、IContext 和 IContextCallback。

對於在 COM+ 應用程式內執行的元件，支援下列介面來存取內容屬性：IObjectContext、IObjectContextActivity、IObjectContextInfo 和 IContextState。

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	combaseapi.h (包含 Objbase.h)
程式庫	Ole32.lib
Dll	Ole32.dll