IFunctionInstanceCollectionQuery::Metode execute (functiondiscoveryapi.h)

[Penemuan Fungsi tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Melakukan kueri yang ditentukan oleh IFunctionDiscovery::CreateInstanceCollectionQuery.

Sintaks

HRESULT Execute(
  [out] IFunctionInstanceCollection **ppIFunctionInstanceCollection
);

Parameter

[out] ppIFunctionInstanceCollection

Penunjuk ke penunjuk antarmuka IFunctionInstanceCollection yang menerima koleksi instans fungsi yang diminta.

Menampilkan nilai

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Kueri yang telah ditentukan sebelumnya adalah kueri kategori berlapis. Saat kueri yang telah ditentukan sebelumnya dijalankan, setiap penyedia yang mengembalikan instans fungsi juga mengembalikan nilai HRESULT. Nilai HRESULT penyedia dikumpulkan, dan nilai yang dikembalikan oleh metode Execute mencerminkan hasil agregat ini. Hasil dikumpulkan sebagai berikut:

• Jika semua penyedia mengembalikan S_OK, Jalankan mengembalikan S_OK.
• Jika setidaknya satu penyedia mengembalikan E_PENDING, dan semua penyedia lain mengembalikan S_OK atau E_PENDING, Jalankan mengembalikan E_PENDING.
• Jika semua penyedia mengembalikan nilai kesalahan (yaitu, nilai selain S_OK atau E_PENDING), Execute mengembalikan nilai kesalahan yang dikembalikan oleh penyedia jaringan yang terakhir dikueri. Selain itu, jika rutinitas panggilan balik IFunctionDiscoveryNotification klien diberikan ke IFunctionDiscovery::CreateInstanceCollectionQuery, pemberitahuan OnError dikirim untuk setiap penyedia. Setiap pemberitahuan OnError berisi HRESULT yang dikembalikan oleh penyedia.
• Jika setidaknya satu penyedia mengembalikan nilai kesalahan, dan semua penyedia lain mengembalikan S_OK, Jalankan mengembalikan S_OK. Pemberitahuan OnError dikirim seperti yang dijelaskan di atas.
• Jika setidaknya satu penyedia mengembalikan nilai kesalahan, dan setidaknya satu penyedia mengembalikan E_PENDING, Jalankan mengembalikan E_PENDING. Pemberitahuan OnError dikirim seperti yang dijelaskan di atas.

Ketika Execute mengembalikan E_PENDING, kumpulan hasil akan dikembalikan secara asinkron melalui antarmuka IFunctionDiscoveryNotification yang disediakan untuk metode CreateInstanceCollectionQuery dari IFunctionDiscovery. ppIFunctionInstanceCollection mungkin NULL atau mungkin berisi tataan hasil parsial. Enumerasi selesai setelah metode OnEventIFunctionDiscoveryNotification dipanggil dengan FD_EVENTID_SEARCHCOMPLETE. Setelah peristiwa FD_EVENTID_SEARCHCOMPLETE diterima, pemberitahuan tambahan akan diperbarui untuk hasilnya.

Keterangan

Metode ini harus dipanggil oleh program klien sebelum data apa pun dapat diambil dari objek kueri. Ketika dipanggil, metode ini melakukan hal berikut:

1. Mengambil objek pengumpulan instans fungsi.
2. Mengkueri penyedia kategori yang diteruskan ke IFunctionDiscovery::CreateInstanceCollectionQuery.
3. Mengambil penyedia kategori.
4. Mengkueri penyedia kategori menggunakan data subkategori untuk menghasilkan koleksi menggunakan batasan kueri.
5. Memulai mekanisme pemberitahuan pembaruan jika alamat rutinitas panggilan balik IFunctionDiscoveryNotification program klien disediakan untuk IFunctionDiscovery::CreateInstanceCollectionQuery.
6. Cache data pengumpulan dan pengembalian.

Persyaratan

Lihat juga

Kueri Penemuan Fungsi

IFunctionInstanceCollectionQuery