Fungsi CoGetObjectContext (combaseapi.h)

Mengembalikan konteks untuk objek saat ini.

Sintaks

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

Parameter

[in] riid

Referensi ke ID antarmuka yang diimplementasikan pada objek konteks.

Untuk objek yang berjalan dalam aplikasi COM, IID_IComThreadingInfo, IID_IContext, dan IID_IContextCallback tersedia.

Untuk objek yang berjalan dalam aplikasi COM+, IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo, dan IID_IContextState tersedia.

[out] ppv

Alamat penunjuk ke antarmuka yang ditentukan oleh riid pada objek konteks.

Nilai kembali

Fungsi ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Konteks objek berhasil diambil.
E_NOINTERFACE	Antarmuka yang diminta tidak tersedia.
CO_E_NOTINITIALIZED	Sebelum fungsi ini dapat dipanggil, fungsi CoInitializeEx harus dipanggil pada utas saat ini.

Keterangan

CoGetObjectContext mengambil konteks untuk objek tempat objek dipanggil, dan mengembalikan pointer ke antarmuka yang dapat digunakan untuk memanipulasi properti konteks. Properti konteks digunakan untuk menyediakan layanan ke komponen yang dikonfigurasi yang berjalan dalam aplikasi COM+.

Untuk komponen yang berjalan dalam aplikasi COM, antarmuka berikut didukung untuk mengakses properti konteks: IComThreadingInfo, IContext, dan IContextCallback.

Untuk komponen yang berjalan dalam aplikasi COM+, antarmuka berikut didukung untuk mengakses properti konteks: IObjectContext, IObjectContextActivity, IObjectContextInfo, dan IContextState.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

Konteks dan Model Utas