Fungsi GetRunningObjectTable (objbase.h)

  • Artikel

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)

Lihat juga

IBindCtx::GetRunningObjectTable

IMoniker

IRunningObjectTable