ICredentialProviderEvents：：CredentialsChanged 方法 (credentialprovider.h)

發出登入 UI 或認證 UI 的訊號，指出列舉的認證清單已變更。 當認證數目變更、個別認證變更或可用的欄位數目變更時，就會發生這種情況。 這是異步方法。

語法

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

參數

[in] upAdviseContext

類型： UINT_PTR

整數的指標，可唯一識別哪一個認證提供者要求重新列舉。 認證提供者應該會傳回它從此參數中從 建議 收到的介面指標。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

在過去，許多認證提供者都使用 ICredentialProviderEvents：：CredentialsChanged 來更新 UI。 雖然運作正常，但它會重新列舉來自呼叫認證提供者的所有認證。 在某些情況下，此事件的處理可能會導致UI中的閃爍或焦點變更，因為此重新列舉。 因此，不建議只針對UI更新使用 ICredentialProviderEvents：：CredentialsChanged 。 新的建議如下所示：

• 只有在認證提供者需要自動登入或變更其列舉的認證數目時，才使用 ICredentialProviderEvents：：CredentialsChanged 。
• 使用 ICredentialProviderCredentialEvents2 來更新認證提供者的登入 UI 或認證 UI。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	credentialprovider.h