Metode IFunctionDiscovery::CreateInstanceCollectionQuery (functiondiscoveryapi.h)

Artikel
08/23/2023

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

Membuat kueri untuk kumpulan instans fungsi tertentu.

Sintaks

HRESULT CreateInstanceCollectionQuery(
  [in]      const WCHAR                      *pszCategory,
  [in]      const WCHAR                      *pszSubCategory,
  [in]      BOOL                             fIncludeAllSubCategories,
  [in]      IFunctionDiscoveryNotification   *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                   *pfdqcQueryContext,
  [out]     IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);

Parameter

[in] pszCategory

Kategori untuk kueri. Lihat Definisi Kategori.

[in] pszSubCategory

Subkataan untuk kueri. Lihat Definisi Subkataan. Parameter ini bisa NULL.

Kueri subkataan hanya didukung untuk kategori berlapis dan beberapa kategori penyedia. Penyedia Registri, penyedia asosiasi PnP-X, dan penyedia publikasi mendukung kueri subkategori. Penyedia kustom dapat dirancang secara eksplisit untuk mendukung kueri subkataan. Ini berarti parameter pszSubCategory harus diatur ke nilai non-NULL hanya ketika parameter pszCategory diatur ke FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION, atau nilai kategori kustom yang ditentukan untuk kategori berlapis atau penyedia kustom yang mendukung kueri subkategori.

[in] fIncludeAllSubCategories

Jika TRUE, metode ini secara rekursif membuat kueri untuk semua subkategori kategori yang ditentukan dalam pszCategory, mengembalikan koleksi yang berisi instans fungsi dari semua subkategori pszCategory.

Jika FALSE, metode ini membatasi kueri yang dibuat untuk mengembalikan instans fungsi dalam kategori yang ditentukan oleh pszCategory dan subkategori yang ditentukan oleh pszSubCategory.

[in] pIFunctionDiscoveryNotification

Penunjuk ke antarmuka IFunctionDiscoveryNotification yang diterapkan oleh aplikasi panggilan. Parameter ini bisa NULL. Penunjuk ini valid sampai objek kueri yang dikembalikan dirilis.

[in, out] pfdqcQueryContext

Penunjuk ke konteks tempat kueri dibuat. Jenis FDQUERYCONTEXT didefinisikan sebagai DWORDLONG.

[out] ppIFunctionInstanceCollectionQuery

Penunjuk ke penunjuk antarmuka IFunctionInstanceCollectionQuery .

Menampilkan nilai

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

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	Nilai pszCategory atau pIID tidak valid. Nilai yang dikembalikan dalam parameter ppIFunctionInstanceCollectionQuery adalah NULL.
E_OUTOFMEMORY	Metode tidak dapat mengalokasikan memori yang diperlukan untuk melakukan operasi ini.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Nilai pszCategory atau pszSubCategory tidak diketahui.

Keterangan

Jika pIFunctionDiscoveryNotification ditentukan, itu memungkinkan proses pemberitahuan perubahan Penemuan Fungsi. Parameter ini bisa NULL. Namun, diperlukan untuk penyedia jaringan karena mereka tidak mengembalikan hasil yang sinkron. Penyedia jaringan Penemuan Fungsi hanya mengembalikan instans melalui antarmuka IFunctionDiscoveryNotification .

Metode ini hanya menginisialisasi panggilan kueri. Metode Execute antarmuka IFunctionInstanceCollectionQuery yang dikembalikan dalam ppIFunctionInstanceCollectionQuery harus dipanggil untuk melakukan kueri dan mengembalikan data apa pun.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

Lihat juga

Kueri Penemuan Fungsi

IFunctionDiscovery

Bagikan melalui