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,以及下列值。
傳回碼 | 描述 |
---|---|
|
已成功擷取對象內容。 |
|
要求的介面無法使用。 |
|
必須先在目前線程上呼叫 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 |