Antarmuka IServiceProvider (servprov.h)
Menyediakan mekanisme akses generik untuk menemukan layanan yang diidentifikasi GUID.
Warisan
Antarmuka IServiceProvider mewarisi dari antarmuka IUnknown.
Metode
Antarmuka IServiceProvider memiliki metode ini.
IServiceProvider::QueryService Bertindak sebagai metode pabrik untuk layanan apa pun yang diekspos melalui implementasi IServiceProvider. |
IServiceProvider::QueryService Bertindak sebagai metode pabrik untuk layanan apa pun yang diekspos melalui implementasi IServiceProvider. Menerima parameter CLSID. |
Keterangan
Antarmuka IServiceProvider adalah mekanisme akses generik untuk menemukan layanan yang diidentifikasi GUID yang disediakan melalui kontrol atau objek lain yang dapat dikomunikasikan oleh layanan. Misalnya, objek yang disematkan (seperti kontrol OLE) biasanya hanya berkomunikasi dengan objek situs klien terkait dalam kontainer melalui antarmuka IOleClientSite yang disediakan dengan menggunakan IOleObject::SetClientSite. Objek yang disematkan harus meminta situs klien untuk beberapa layanan lain yang didukung kontainer ketika layanan tersebut mungkin tidak diterapkan di situs klien.
Situs klien harus menyediakan sarana di mana kontrol yang dikelola oleh situs dapat mengakses layanan jika diperlukan. Misalnya, fungsi IOleInPlaceSite::GetWindowContext) dapat digunakan oleh objek atau kontrol di tempat untuk mengakses penunjuk antarmuka untuk objek dokumen yang berisi situs dan objek bingkai yang berisi dokumen. Karena penunjuk antarmuka ini ada pada objek terpisah, kontrol tidak dapat memanggil QueryInterface situs untuk mendapatkan pointer tersebut. Sebagai gantinya, gunakan antarmuka IServiceProvider.
Antarmuka IServiceProvider harus kelebihan beban dari satu metode, QueryService, di mana pemanggil menentukan ID layanan (SID, GUID), IID antarmuka yang akan dikembalikan, dan alamat variabel penunjuk antarmuka pemanggil. Kelebihan beban kedua menyimpulkan IID dari pointer output yang diteruskan ke metode .
IID untuk antarmuka ini IID_IServiceProvider.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Build 22000 |
Server minimum yang didukung | Windows Build 22000 |
Header | servprov.h |