Metode ObjectContext::CreateInstance (comsvcs.h)

Membuat objek menggunakan konteks objek saat ini.

Objek akan memiliki konteks hanya jika komponennya terdaftar dengan COM+.

Sintaks

HRESULT CreateInstance(
  [in]  BSTR    bstrProgID,
  [out] VARIANT *pObject
);

Parameter

[in] bstrProgID

ProgID dari jenis objek yang akan diinstansiasi.

[out] pObject

Referensi ke objek baru.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_UNEXPECTED	Terjadi kesalahan tak terduga. Ini dapat terjadi jika satu objek meneruskan penunjuk ObjectContext ke objek lain dan objek lainnya memanggil CreateInstance menggunakan penunjuk ini. Penunjuk ObjectContext tidak valid di luar konteks objek yang awalnya mendapatkannya.

Keterangan

Saat Anda membuat objek dengan menggunakan CreateInstance, konteks objek baru berasal dari ObjectContext objek saat ini dan properti deklaratif komponen objek baru. Objek baru selalu dijalankan dalam aktivitas yang sama dengan objek yang membuatnya. Jika objek saat ini memiliki transaksi, atribut transaksi komponen objek baru menentukan apakah objek baru dijalankan dalam cakupan transaksi tersebut.

Jika pengaturan atribut transaksi komponen memerlukan transaksi atau mendukung transaksi, objek baru akan mewarisi transaksi pembuatnya. Jika atribut transaksi komponen memerlukan transaksi baru, COM+ memulai transaksi baru untuk objek baru. Jika atribut transaksi komponen tidak mendukung transaksi, objek baru tidak dijalankan di bawah transaksi apa pun.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	comsvcs.h

Lihat juga

ObjectContext