ICredentialProvider 介面 (credentialprovider.h)

公開認證提供者的設定和操作中使用的方法。 所有認證提供者都必須實作此介面。

繼承

ICredentialProvider介面繼承自IUnknown介面。 ICredentialProvider 也有下列類型的成員：

方法

ICredentialProvider介面具有這些方法。

ICredentialProvider：：建議 允許認證提供者透過回呼介面在登入 UI 或認證 UI 中起始事件。
ICredentialProvider：：GetCredentialAt 取得特定的認證。
ICredentialProvider：：GetCredentialCount 取得這個認證提供者下可用的認證數目。
ICredentialProvider：：GetFieldDescriptorAt 取得描述指定欄位的中繼資料。
ICredentialProvider：：GetFieldDescriptorCount 擷取顯示此提供者認證所需的欄位計數。
ICredentialProvider：：SetSerialization 設定認證提供者的序列化特性。
ICredentialProvider：：SetUsageScenario 定義認證提供者有效的案例。 每當初始化認證提供者時呼叫。
ICredentialProvider：：UnAdvise 由登入 UI 或認證 UI 使用，以建議認證提供者不再接受事件回呼。

備註

此介面是您將如何與應用程式的登入 UI 和認證 UI 互動。

具現化的認證提供者會在登入 UI 的整個存留期內維護。 因此，登入 UI 可以維護認證提供者的狀態。 特別是，它會記住哪個提供者和磚提供認證。 這表示當您使用CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_LOGON、CPUS_UNLOCK_WORKSTATION和CPUS_CHANGE_PASSWORD時，可能會儲存狀態資訊。 這不是認證 UI 的情況。 每次應用程式呼叫 CredUIPromptForWindowsCredentials時，認證 UI 都會建立提供者的新實例。 因此，認證 UI 無法記住認證提供者的狀態。

請注意，在一個案例中產生的 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 可能會儲存並用於後續的使用案例中。 因此，您必須確定 您的 ICredentialProvider 實作夠強，足以處理此案例。

Windows 8 會在認證提供者 API 中新增新功能，主要是依使用者群組認證的能力。

規格需求

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

另請參閱

CREDENTIAL_PROVIDER_USAGE_SCENARIO

認證提供者驅動 Windows 登入體驗

Windows 10 中的認證提供者

ICredentialProviderCredential