IFunctionInstanceCollectionQuery::Metode AddQueryConstraint (functiondiscoveryapi.h)

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

Metode AddQueryConstraint menambahkan batasan kueri ke kueri.

Metode ini memungkinkan aplikasi untuk memfilter hasil yang diatur hanya ke instans yang memenuhi batasan ini.

Sintaks

HRESULT AddQueryConstraint(
  [in] const WCHAR *pszConstraintName,
  [in] const WCHAR *pszConstraintValue
);

Parameter

[in] pszConstraintName

Batasan kueri.

[in] pszConstraintValue

Nilai batasan.

Nilai kembali

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

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

Keterangan

Jika beberapa batasan ditambahkan, semua batasan harus didukung untuk memenuhi kueri.

AddQueryConstraint akan gagal dengan kesalahan jika objek IFunctionInstanceCollectionQuery menyertakan semua subkataan dan metode AddQueryConstraint dipanggil dengan parameter pszConstraintName yang diatur ke FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Untuk menghindari kesalahan ini, buat objek IFunctionInstanceCollectionQuery yang tidak menyertakan semua subkataan. Anda dapat membuat objek seperti itu dengan memanggil CreateInstanceCollectionQuery dengan parameter fIncludeAllSubCategories diatur ke false.

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

Definisi Batasan

Kueri Penemuan Fungsi

IFunctionInstanceCollectionQuery