Metode ISSONotification.ReceiveNotification

 

Menerima pemberitahuan dari sistem ENTSSO, seperti perubahan kata sandi.

Syntax

  
HRESULT ReceiveNotification(  
ULONG ulNotificationFlagsIn,  
SReceiveNotification* pReceiveNotification,  
GUID* pguidTrackingId  
);  

Parameter-parameternya

bstrAdapterName
[di] Nama adaptor unik.

ulNotificationFlagsIn
[di] Bendera pemberitahuan untuk mengontrol pemberitahuan ini, dari enumerasi SSO_NOTIFICATION_FLAG.

pReceiveNotification
[di] Pointer untuk pemberitahuan yang diterima.

pguidTrackingId
[out] ID pelacakan. Sistem ENTSSO akan menghasilkan ID pelacakan dan mengembalikannya ke pemanggil. ID pelacakan digunakan untuk tujuan audit dan juga dapat digunakan oleh adaptor untuk menghubungkan respons terhadap permintaan. Parameter ini dapat berupa NULL jika ID pelacakan tidak diperlukan oleh adaptor.

Mengembalikan Nilai

Metode ini mengembalikan HRESULT yang menunjukkan apakah selesai dengan benar. Untuk informasi selengkapnya, lihat bagian Nilai Kesalahan.

Nilai Kesalahan

Metode ini mengembalikan HRESULT yang berisi salah satu nilai dalam tabel berikut.

Nilai	Description
S_OK	Metode berhasil.
E_ACCESSDENIED	Akses ditolak.
ENTSSO_E_NO_SERVER	Tidak dapat menghubungi server ENTSSO. Periksa apakah layanan ENTSSO sedang berjalan.
ENTSSO_E_NO_NOTIFICATIONS	Tidak ada pemberitahuan yang akan diterima.
ENTSSO_E_WRONG_STATE	Metode ini telah dipanggil dalam keadaan yang salah.

Komentar

Anda dapat menggunakan ReceiveNotification untuk menerima perubahan kata sandi dan pemberitahuan lainnya dari sistem ENTSSO.

Anda dapat memanggil ReceiveNotification dengan atau tanpa bendera WAIT. Jika Anda menentukan bendera WAIT, ReceiveNotification memblokir hingga pemberitahuan tersedia. Melakukannya memungkinkan Anda menentukan apakah Anda ingin mendedikasikan utas untuk menerima pemberitahuan dari layanan ENTSSO, atau apakah Anda ingin menggunakan handel peristiwa yang dikembalikan dari InitializeAdapter untuk melakukan penantian Anda sendiri, dibagikan dengan peristiwa lain.

Jika ReceiveNotification menunggu saat Anda memanggil ShutdownAdapter, maka ReceiveNotification mengembalikan pemberitahuan SHUTDOWN sebagai pemberitahuan terakhir. Pemberitahuan SHUTDOWN mendahului pemberitahuan lain yang tertunda.

Ada kemungkinan bahwa beberapa utas dapat memanggil ReceiveNotification untuk nama adaptor yang sama. Dalam hal ini, permintaan berutas tunggal di layanan ENTSSO, dan hanya satu ReceiveNotification yang lengkap dengan informasi yang valid. Utas selesai dengan pemberitahuan berikutnya atau TIDAK ADA. Alasannya adalah bahwa masing-masing utas ini menunggu peristiwa yang sama.

Persyaratan

Platform: Windows

Lihat Juga

ANTARMUKA ISSONotification (COM)
Anggota ISSONotification
Pemrograman dengan Akses Menyeluruh Enterprise