Fungsi DevCreateObjectQueryFromIdsEx (devquery.h)

Membuat kueri perangkat untuk mengambil properti berdasarkan parameter kueri yang ditentukan, parameter yang diperluas, dan daftar ID objek.

Sintaksis

HRESULT DevCreateObjectQueryFromIdsEx(
  [in]           DEV_OBJECT_TYPE                 ObjectType,
  [in]           PCZZWSTR                        pszzObjectIds,
  [in]           ULONG                           QueryFlags,
  [in]           ULONG                           cRequestedProperties,
  [in, optional] const DEVPROPCOMPKEY            *pRequestedProperties,
  [in]           ULONG                           cFilterExpressionCount,
  [in, optional] const DEVPROP_FILTER_EXPRESSION *pFilter,
  [in]           ULONG                           cExtendedParameterCount,
  [in, optional] const DEV_QUERY_PARAMETER       *pExtendedParameters,
  [in]           PDEV_QUERY_RESULT_CALLBACK      pCallback,
  [in, optional] PVOID                           pContext,
  [out]          PHDEVQUERY                      phDevQuery
);

Parameter

[in] ObjectType

Nilai dari enumerasi DEV_OBJECT_TYPE yang menentukan tipe objek yang harus dioperasikan kueri ini.

[in] pszzObjectIds

Daftar multi-sz pengidentifikasi objek untuk objek yang harus dioperasikan kueri. Untuk informasi tentang string multi-sz, lihat REG_MULTI_SZ.

[in] QueryFlags

Kombinasi nilai DEV_QUERY_FLAGS yang digabungkan dengan menggunakan operasi OR bitwise.

[in] cRequestedProperties

Jumlah struktur DEVPROPCOMPKEY yang disediakan dalam pRequestedProperties. Jika DevQueryFlagAllProperties ditentukan, ini harus diatur ke 0.

[in, optional] pRequestedProperties

Secara opsional menyediakan array struktur DEVPROPCOMPKEY yang menentukan properti yang harus diambil untuk objek dalam hasil kueri yang ditetapkan ketika pCallback dipanggil untuk memberi tahu kueri penambahan objek ke tataan hasilnya.
Jika DevQueryFlagUpdateResults ditentukan dalam QueryFlags, kueri akan diberi tahu jika nilai salah satu properti ini berubah untuk objek apa pun dalam kumpulan hasil kueri.

Bidang LocaleName dari struktur DEVPROPCOMPKEY diabaikan dan harus diatur ke NULL.

Jika cRequestedProperties adalah 0, ini harus NULL.

[in] cFilterExpressionCount

Jumlah struktur DEVPROP_FILTER_EXPRESSION yang disediakan dalam pFilter.

[in, optional] pFilter

Secara opsional menyediakan array struktur DEVPROP_FILTER_EXPRESSION yang menentukan kriteria filter untuk objek apa yang harus menjadi bagian dari tataan hasil kueri. Jika cFilterExpressionCount adalah 0, ini harus NULL.

[in] cExtendedParameterCount

Dicadangkan untuk penggunaan sistem. Harus diatur ke 0.

[in, optional] pExtendedParameters

Dicadangkan untuk penggunaan sistem. Harus diatur ke NULL.

[in] pCallback

Fungsi panggilan balik PDEV_QUERY_RESULT_CALLBACK yang hasil untuk kueri ini harus dikirim ke

[in, optional] pContext

Konteks yang disediakan pemanggil. Nilai ini diteruskan ke fungsi panggilan balik yang tidak dimodifikasi.

[out] phDevQuery

Penunjuk yang menerima handel yang mewakili kueri. Jika DevQueryFlagsUpdateResults ditentukan, maka kueri akan menerima pembaruan hingga handel ditutup. Panggil DevCloseObjectQuery untuk menutup handel ini untuk menghentikan kueri.

Mengembalikan nilai

S_OK dikembalikan jika kueri berhasil dibuat; jika tidak, nilai kesalahan yang sesuai.

Komentar

Untuk contoh pembuatan kueri perangkat untuk mengambil properti berdasarkan parameter kueri yang ditentukan dan daftar ID objek, lihat DevCreateObjectQueryFromIds.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 10 versi 1809
server minimum yang didukung	Windows Server 2019
Header	devquery.h
Pustaka	Onecore.lib
DLL	Cfgmgr32.dll

Lihat juga

DevCreateObjectQuery