ICredentialProviderCredential2 介面 (credentialprovider.h)
藉由新增方法來擷取使用者的安全性識別碼 (SID) ,以擴充 ICredentialProviderCredential 介面。 認證與該使用者相關聯,而且可以群組在使用者的磚底下。
繼承
ICredentialProviderCredential2介面繼承自ICredentialProviderCredential。 ICredentialProviderCredential2 也有下列類型的成員:
方法
ICredentialProviderCredential2介面具有這些方法。
ICredentialProviderCredential2::GetUserSid 擷取與此認證相關聯之使用者 (SID) 的安全性識別碼。 |
備註
建立 V2 認證提供者需要這個類別。 V2 認證提供者可為使用者提供個人化登入體驗。 認證提供者會告知登入 UI 哪些登入選項可供使用者使用。 建議新的認證提供者應該是 V2 認證提供者。
若要建立 ICredentialProviderCredential2 實例, GetUserSid 函式必須傳回有效的 SID。 Valid 是由傳回的 SID 所定義,由登入 UI 目前列舉的使用者之一所定義。
取得可用使用者並判斷您要與哪些使用者建立關聯的工具是 ICredentialProviderUserArray 物件。 此物件包含可查詢的 ICredentialProviderUser 物件清單,以取得將列舉之使用者的相關資訊。 例如,您可以使用 GetStringValue 取得使用者的 SID 或使用者名稱,以及分別傳入 參數的 PKEY_Identity_PrimarySid 或 PKEY_Identity_USerName 。 您甚至可以使用 SetProviderFilter 篩選結果,只顯示可用使用者的子集。
使用 ICredentialProviderUserArray 是選擇性的,但它是取得建立有效 SID 值所需資訊的便利方式。 若要取得登入 UI 將列舉的使用者清單,請實作ICredentialProviderSetUserArray介面,以從 SetUserArray 取得ICredentialProviderUserArray物件。 登入 UI 會在GetCredentialCount之前呼叫SetUserArray,因此當認證提供者即將傳回認證時,ICredentialProviderUserArray物件便已就緒。
V2 認證提供者會以顯示在 [登入選項] 連結下方的圖示來表示。 若要為您的認證提供者提供圖示,請在認證本身中定義CPFT_TILE_IMAGE CREDENTIAL_PROVIDER_FIELD_TYPE。 然後確定CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR的guidFieldType設定為CPFG_CREDENTIAL_PROVIDER_LOGO。 圖示的建議大小為 72 x 72 圖元。
類似于指定認證提供者的圖示,您也可以指定文字字串來識別您的認證提供者。 當使用者將滑鼠停留在圖示上方時,此字串會出現在快顯視窗中。 若要這樣做,請在認證本身定義CPFT_SMALL_TEXT CREDENTIAL_PROVIDER_FIELD_TYPE。 然後確定CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR的guidFieldType設定為CPFG_CREDENTIAL_PROVIDER_LABEL。 此字串應該補充上述的認證提供者圖示,並足以讓使用者瞭解其內容。 例如,圖片密碼提供者的描述是「圖片密碼」。
實作時機
實作此介面,以將認證磚與登入 UI 中的特定使用者磚產生關聯。規格需求
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | credentialprovider.h |