Metode IEventSystem::QueryS (eventsys.h)

Artikel
03/14/2023

Mengambil kumpulan objek langganan atau peristiwa dari penyimpanan data peristiwa.

Sintaks

HRESULT QueryS(
  [in]          BSTR     progID,
  [in]          BSTR     queryCriteria,
  [out, retval] IUnknown **ppInterface
);

Parameter

[in] progID

ProgID dari kelas objek yang akan dikueri. Ini harus menjadi pengidentifikasi kelas objek peristiwa yang valid. Parameter ini bisa menjadi salah satu nilai berikut:

PROGID_EventClass
PROGID_EventClassCollection
PROGID_EventSubscription
PROGID_EventSubscriptionCollection

[in] queryCriteria

Kriteria kueri. Untuk detail tentang membentuk ekspresi yang valid untuk parameter ini, lihat bagian Keterangan di bawah ini.

[out, retval] ppInterface

Alamat penunjuk ke objek yang diperoleh sebagai hasil dari kueri. Parameter ini tidak boleh NULL. Bergantung pada objek yang ditentukan oleh parameter progID , ini adalah penunjuk ke salah satu antarmuka berikut:

Menampilkan nilai

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_POINTER, E_OUTOFMEMORY, E_UNEXPECTED, dan E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
EVENT_E_QUERYSYNTAX	Terjadi kesalahan sintaks saat mencoba mengevaluasi string kueri.
EVENT_E_QUERYFIELD	Nama bidang yang tidak valid digunakan dalam string kueri.

Keterangan

Pemanggil bertanggung jawab untuk membebaskan memori yang dialokasikan melalui parameter ppInterface .

Kriteria kueri yang ditentukan oleh parameter queryCriteria dapat berupa "ALL", untuk menentukan permintaan untuk semua objek langganan, atau ekspresi Boolean yang menunjukkan satu atau beberapa kondisi yang harus dipenuhi objek langganan untuk disertakan dalam hasil kueri. Ekspresi yang valid adalah dari formulir berikut:

[TIDAK] nilai propertynamerelationalOperator. Operator relasional yang valid adalah sebagai berikut:

==, =, !=, <>, ~=. Nilai yang valid adalah "string", 'string', {GUID}, TRUE, FALSE, NULL.

Ekspresi Boolean individual dapat digabungkan dengan AND atau OR. Ekspresi dapat ditumpuk dalam tanda kurung untuk memberlakukan urutan evaluasi tertentu.

Berikut ini adalah beberapa contoh kriteria kueri yang valid:

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}"

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	eventsys.h

Lihat juga

IEventSystem

Bagikan melalui