Bagikan melalui

Fungsi CoGetObject (objbase.h)

  • Artikel

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