Share via

Metode IRunningObjectTable::GetObject (objidl.h)

  • Artikel

Menentukan apakah objek yang diidentifikasi oleh moniker yang ditentukan sedang berjalan, dan jika ya, mengambil pointer ke objek tersebut.

Sintaks

HRESULT GetObject(
  [in]  IMoniker *pmkObjectName,
  [out] IUnknown **ppunkObject
);

Parameter

[in] pmkObjectName

Penunjuk ke antarmuka IMoniker pada moniker.

[out] ppunkObject

Penunjuk ke variabel pointer IUnknown yang menerima penunjuk antarmuka ke objek yang sedang berjalan. Ketika berhasil, implementasi memanggil AddRef pada objek ; adalah tanggung jawab pemanggil untuk memanggil Rilis. Jika objek tidak berjalan atau jika terjadi kesalahan, implementasi menetapkan *ppunkObject ke NULL.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Menunjukkan bahwa pmkObjectName ditemukan di ROT dan pointer diambil.
S_FALSE
 Tidak ada entri untuk pmkObjectName di ROT, atau bahwa objek yang diidentifikasinya tidak lagi berjalan (dalam hal ini, entri dicabut).

Keterangan

Metode ini memeriksa ROT untuk moniker yang ditentukan oleh pmkObjectName. Jika moniker tersebut sebelumnya telah didaftarkan dengan panggilan ke IRunningObjectTable::Register, metode ini mengembalikan pointer yang terdaftar pada saat itu.

Catatan untuk Penelepon

Umumnya, Anda memanggil metode IRunningObjectTable::GetObject hanya jika Anda menulis kelas moniker Anda sendiri (yaitu, menerapkan antarmuka IMoniker ). Anda biasanya memanggil metode ini dari implementasi IMoniker::BindToObject Anda.

Namun, perhatikan bahwa tidak semua implementasi IMoniker::BindToObject perlu memanggil metode ini. Jika Anda mengharapkan moniker Anda memiliki awalan (ditunjukkan oleh parameter pmkToLeftnon-NULL ke IMoniker::BindToObject), Anda tidak boleh memeriksa ROT. Alasannya adalah bahwa hanya moniker lengkap yang terdaftar di ROT, dan jika moniker Anda memiliki awalan, moniker Anda adalah bagian dari komposit dan dengan demikian tidak lengkap. Sebagai gantinya, moniker Anda harus meminta layanan dari objek yang diidentifikasi oleh awalan (misalnya, kontainer objek yang diidentifikasi oleh moniker Anda).

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 objidl.h

Lihat juga

IMoniker::BindToObject

IRunningObjectTable