Metode IRunningObjectTable::GetObject (objidl.h)
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 |
---|---|
|
Menunjukkan bahwa pmkObjectName ditemukan di ROT dan pointer diambil. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk