Bagikan melalui

IEventSystem::Hapus metode (eventsys.h)

  • Artikel

Menghapus satu atau beberapa objek langganan atau peristiwa dari penyimpanan data peristiwa.

Sintaks

HRESULT Remove(
  [in]  BSTR progID,
  [in]  BSTR queryCriteria,
  [out] int  *errorIndex
);

Parameter

[in] progID

ProgID dari kelas objek yang akan dihapus. 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 .

Menampilkan nilai

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, 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.
EVENT_E_NOT_ALL_REMOVED
 Tidak semua objek yang diminta dapat dihapus.

Keterangan

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

   
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