Metode ISSONotification.SendNotification

 

Mengirim pemberitahuan, seperti perubahan kata sandi, dari adaptor ke sistem ENTSSO.

Syntax

  
HRESULT SendNotification(  
SSendNotification SendNotification,  
GUID* pguidTrackingId  
);  

Parameter-parameternya

SendNotification
[di] Pemberitahuan untuk dikirim ke ENTSSO dari adaptor.

pguidTrackingId
[out] Ketika metode ini kembali, berisi ID pelacakan yang dihasilkan oleh ENTSSO. Anda dapat menggunakan ID pelacakan untuk tujuan audit atau untuk menghubungkan respons permintaan. Mungkin NULL.

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_WRONG_STATE	Metode ini telah dipanggil dalam keadaan yang salah.
ENTSSO_E_INVALID_NOTIFICATION	Jenis pemberitahuan tidak valid.

Komentar

Anda dapat menggunakan SendNotification untuk mengirim perubahan kata sandi dan pemberitahuan lainnya ke sistem ENTSSO.

Jika SendNotification mengembalikan S_OK, ini tidak berarti bahwa perubahan kata sandi selesai pada sistem tujuan. Sebaliknya, menerima S_OK berarti ENTSSO telah menerima dan akhirnya akan menyelesaikan permintaan Anda.

Perubahan kata sandi dari sistem eksternal dapat memiliki beberapa konsekuensi:

• Jika sinkronisasi kata sandi parsial dikonfigurasi, maka database SSO mungkin diperbarui, jika pemetaan saat ini ada untuk akun eksternal.

• Jika sinkronisasi kata sandi penuh dikonfigurasi, perubahan kata sandi mungkin juga dilakukan ke akun Windows.

Jika akun eksternal tidak memiliki pemetaan saat ini dalam database SSO, perubahan kata sandi mungkin tidak berpengaruh.

Pemberitahuan lengkap perubahan kata sandi dikeluarkan ketika perubahan kata sandi dianggap selesai dari sudut pandang ENTSSO, yang seperti yang dibahas di atas, dapat berarti hal yang berbeda. Dalam beberapa kasus, itu bisa berarti tidak ada perubahan yang dilakukan, bahwa hanya database SSO yang diperbarui, atau bahwa kata sandi Windows diubah.

Perhatikan bahwa pemberitahuan lengkap perubahan kata sandi yang dikirim kembali ke adaptor tidak sepenuhnya dapat diandalkan. Dalam beberapa kondisi kesalahan, Sign-On tunggal mungkin tidak pernah benar-benar menerima pemberitahuan yang diminta.

Di ENTSSO, definisi kredensial, seperti yang dikirim oleh SendNotification untuk pembaruan kata sandi, lebih fleksibel daripada kata sandi sederhana. Saat menentukan aplikasi SSO, Anda juga menentukan bidang kredensial. Bidang mengidentifikasi label yang akan digunakan untuk bidang UI, dan apakah bidang tersebut ditutupi atau tidak. Selain itu, ada juga bendera khusus yang menentukan apakah bidang harus disinkronkan atau tidak. Bidang 0 adalah kasus khusus dan menentukan label untuk ID pengguna. Untuk informasi selengkapnya, lihat Antarmuka ISSOAdmin.

Persyaratan

Platform: Windows

Lihat Juga

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