Metode IFunctionDiscovery::CreateInstanceQuery (functiondiscoveryapi.h)

[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 instans fungsi tertentu.

Sintaks

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

Parameter

[in] pszFunctionInstanceIdentity

Pengidentifikasi instans fungsi.

[in] pIFunctionDiscoveryNotification

Penunjuk ke antarmuka IFunctionDiscoveryNotification yang diterapkan oleh aplikasi panggilan. Jika ditentukan, ini memungkinkan proses pemberitahuan perubahan Penemuan Fungsi. Parameter ini bisa NULL; namun diperlukan untuk penyedia jaringan.

[in, out] pfdqcQueryContext

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

[out] ppIFunctionInstanceQuery

Penunjuk ke penunjuk antarmuka IFunctionInstanceQuery yang digunakan untuk mengembalikan kueri yang dihasilkan.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	ppIFunctionInstanceQuery adalah NULL.
E_OUTOFMEMORY	Metode tidak dapat mengalokasikan memori yang diperlukan untuk melakukan operasi ini.

Keterangan

Penyedia Jaringan Penemuan Fungsi hanya mengembalikan instans melalui antarmuka IFunctionDiscoveryNotification .

Metode ini hanya menginisialisasi panggilan kueri. Metode Execute antarmuka IFunctionInstanceQuery yang dikembalikan di ppIFunctionInstanceQuery harus dipanggil untuk melakukan kueri dan mengembalikan data apa pun.

Persyaratan

Persyaratan	Nilai
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