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 |