Fungsi CoGetObject (objbase.h)

Artikel
03/05/2024

Mengonversi nama tampilan menjadi moniker yang mengidentifikasi objek bernama, lalu mengikat ke objek yang diidentifikasi oleh moniker.

Sintaks

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

Parameter

[in] pszName

Nama tampilan objek yang akan dibuat.

[in, optional] pBindOptions

Opsi pengikatan yang digunakan untuk membuat moniker yang membuat objek aktual. Untuk detailnya, lihat BIND_OPTS. Parameter ini bisa NULL.

[in] riid

Referensi ke pengidentifikasi antarmuka yang diimplementasikan pada objek yang akan dibuat.

[out] ppv

Alamat pointer ke antarmuka yang ditentukan oleh riid pada objek yang dibuat.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Objek berhasil dibuat.
MK_E_SYNTAX	Parameter pszName bukan nama tampilan yang dibentuk dengan benar.
MK_E_NOOBJECT	Objek yang diidentifikasi oleh moniker ini, atau beberapa objek yang diidentifikasi oleh moniker komposit di mana moniker ini adalah bagian, tidak dapat ditemukan.
MK_E_EXCEEDEDDEADLINE	Operasi pengikatan tidak dapat diselesaikan dalam batas waktu yang ditentukan oleh struktur BIND_OPTS yang diteruskan dalam pBindOptions.
MK_E_CONNECTMANUALLY	Operasi pengikatan memerlukan bantuan dari pengguna akhir. Alasan paling umum untuk mengembalikan nilai ini adalah bahwa kata sandi diperlukan atau bahwa floppy perlu dipasang.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED	Objek perantara ditemukan tetapi tidak mendukung antarmuka yang diperlukan untuk menyelesaikan operasi pengikatan. Misalnya, moniker item mengembalikan nilai ini jika kontainernya tidak mendukung antarmuka IOleItemContainer .

Keterangan

CoGetObject merangkum panggilan ke fungsi pustaka COM CreateBindCtx, MkParseDisplayName, dan IMoniker::BindToObject.

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	objbase.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

BIND_OPTS

Bagikan melalui