ICredentialProvider::Metode saran (credentialprovider.h)

Memungkinkan penyedia kredensial untuk memulai peristiwa di UI Masuk atau Antarmuka Pengguna kredensial melalui antarmuka panggilan balik.

Sintaks

HRESULT Advise(
  [in] ICredentialProviderEvents *pcpe,
  [in] UINT_PTR                  upAdviseContext
);

Parameter

[in] pcpe

Jenis: ICredentialProviderEvents*

Penunjuk ke antarmuka panggilan balik ICredentialProviderEvents untuk digunakan sebagai mekanisme pemberitahuan.

[in] upAdviseContext

Jenis: UINT_PTR

Penunjuk ke bilangan bulat yang secara unik mengidentifikasi penyedia kredensial mana yang telah meminta enumerasi ulang.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak perlu diimplementasikan, dan harus mengembalikan E_NOTIMPL jika tidak. Mungkin tidak ada alasan untuk memanggilnya, seperti jika UI Masuk atau Antarmuka Pengguna Kredensial tidak pernah berubah atau diperbarui.

Metode ini memungkinkan UI Masuk dan UI Kredensial untuk meneruskan penunjuk ICredentialProviderEvents ke penyedia kredensial. Ini memungkinkan penyedia kredensial untuk memiliki komunikasi panggilan balik asinkron dengan UI Masuk atau Kredensial. Misalnya, penyedia kartu pintar mungkin ingin menghitung kredensial lagi saat kartu pintar baru dimasukkan. Untuk memicu UI Masuk untuk mendapatkan kredensial lagi, penyedia kredensial harus memanggil CredentialsChanged yang menyediakan pengidentifikasi upAdviseContext .

Penyedia info masuk yang menerapkan metode ini memiliki tanggung jawab untuk memanggil AddRef pada ICredentialProviderEvents yang disediakan. Penyedia info masuk tersebut juga perlu memanggil Rilis selama metode UnAdvise .

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	credentialprovider.h

Lihat juga

ICredentialProvider

ICredentialProvider::UnAdvise