Share via

ICredentialProvider：：Advise 方法 (credentialprovider.h)

  • 發行項

允許認證提供者透過回呼介面在登入 UI 或認證 UI 中起始事件。

語法

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

參數

[in] pcpe

類型： ICredentialProviderEvents*

要做為通知機制的 ICredentialProviderEvents 回呼介面指標。

[in] upAdviseContext

類型： UINT_PTR

整數的指標，可唯一識別哪些認證提供者已要求重新列舉。

傳回值

類型： HRESULT

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

備註

方法不需要實作，而且如果沒有，則應該傳回 E_NOTIMPL 。 可能沒有理由呼叫它，例如登入 UI 或認證 UI 從未變更或更新。

此方法可讓登入 UI 和認證 UI 傳遞認證提供者的 ICredentialProviderEvents 指標。 這可讓認證提供者與登入或認證 UI 進行非同步回呼通訊。 例如，當插入新的智慧卡時，智慧卡提供者可能會想要再次列舉認證。 若要再次觸發登入 UI 以取得認證，認證提供者應該呼叫 CredentialChanged ，並提供 upAdviseCoNtext 識別碼。

實作此方法的認證提供者負責在提供的ICredentialProviderEvents上呼叫AddRef。 這些認證提供者也需要在UnAdvise方法期間呼叫Release。

規格需求

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

另請參閱

ICredentialProvider

ICredentialProvider：：UnAdvise