Fungsi GetRunningObjectTable (objbase.h)
Mengembalikan penunjuk ke antarmuka IRunningObjectTable pada tabel objek berjalan lokal (ROT).
Sintaks
HRESULT GetRunningObjectTable(
[in] DWORD reserved,
[out] LPRUNNINGOBJECTTABLE *pprot
);
Parameter
[in] reserved
Parameter ini dicadangkan dan harus 0.
[out] pprot
Alamat variabel pointer IRunningObjectTable* yang menerima penunjuk antarmuka ke ROT lokal. Ketika fungsi berhasil, pemanggil bertanggung jawab untuk memanggil Rilis pada penunjuk antarmuka. Jika terjadi kesalahan, *pprot tidak terdefinisi.
Mengembalikan nilai
Fungsi ini dapat mengembalikan nilai pengembalian standar E_UNEXPECTED dan S_OK.
Keterangan
Setiap stasiun kerja memiliki ROT lokal yang mempertahankan tabel objek yang telah terdaftar sebagai berjalan di komputer tersebut. Fungsi ini mengembalikan penunjuk antarmuka IRunningObjectTable , yang menyediakan akses ke tabel tersebut.
Penyedia Moniker, yang membagikan moniker yang mengidentifikasi objek sehingga dapat diakses oleh orang lain, harus memanggil GetRunningObjectTable. Gunakan penunjuk antarmuka yang dikembalikan oleh fungsi ini untuk mendaftarkan objek Anda saat mulai berjalan, untuk merekam waktu objek tersebut dimodifikasi, dan untuk mencabut pendaftaran mereka ketika mereka berhenti berjalan. Lihat antarmuka IRunningObjectTable untuk informasi selengkapnya.
Sumber tautan dokumen campuran adalah contoh penyedia moniker yang paling umum. Ini termasuk aplikasi server yang mendukung penautan ke dokumen mereka (atau bagian dari dokumen) dan aplikasi kontainer yang mendukung penautan ke penyematan dalam dokumen mereka. Aplikasi server yang tidak mendukung penautan juga dapat menggunakan ROT untuk bekerja sama dengan aplikasi kontainer yang mendukung penautan ke penyematan.
Jika Anda mengimplementasikan antarmuka IMoniker untuk menulis kelas moniker baru, dan Anda memerlukan penunjuk antarmuka ke ROT, panggil IBindCtx::GetRunningObjectTable daripada fungsi GetRunningObjectTable . Ini memungkinkan implementasi antarmuka IBindCtx di masa mendatang untuk memodifikasi perilaku pengikatan.
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 | objbase.h |
| Pustaka | Ole32.lib |
| DLL | Ole32.dll |
| Set API | ext-ms-win-com-ole32-l1-1-0 (diperkenalkan dalam Windows 8) |