Bagikan melalui

IEventSystem::Metode kueri (eventsys.h)

  • Artikel

Mengambil kumpulan objek langganan atau peristiwa dari penyimpanan data peristiwa.

Sintaks

HRESULT Query(
  [in]          BSTR     progID,
  [in]          BSTR     queryCriteria,
  [out]         int      *errorIndex,
  [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] errorIndex

Lokasi, dinyatakan sebagai offset, dari kesalahan dalam parameter queryCriteria .

[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:

Nilai kembali

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] nilaipropertynamerelationalOperator. 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

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