Interfaccia ICredentialProviderCredential2 (credentialprovider.h)
Estende l'interfaccia ICredentialProviderCredential aggiungendo un metodo che recupera l'identificatore di sicurezza (SID) di un utente. Le credenziali sono associate a tale utente e possono essere raggruppate nel riquadro dell'utente.
Ereditarietà
L'interfaccia ICredentialProviderCredential2 eredita da ICredentialProviderCredentialCredential. ICredentialProviderCredential2 include anche questi tipi di membri:
Metodi
L'interfaccia ICredentialProviderCredential2 include questi metodi.
| ICredentialProviderCredential2::GetUserSid Recupera l'identificatore di sicurezza (SID) dell'utente associato a questa credenziale. |
Commenti
Questa classe è necessaria per la creazione di un provider di credenziali V2. I provider di credenziali V2 forniscono un'esperienza di accesso personalizzata per l'utente. Ciò si verifica dal provider di credenziali che indica all'interfaccia utente di accesso le opzioni di accesso disponibili per un utente. È consigliabile che i nuovi provider di credenziali siano provider di credenziali V2.
Per creare un'istanza di ICredentialProviderCredential2 , è necessario restituire un SID valido dalla funzione GetUserSid . Valido è definito dal SID restituito per uno degli utenti attualmente enumerati dall'interfaccia utente di accesso.
Uno strumento utile per ottenere gli utenti disponibili e determinare quali utenti si desidera associare è l'oggetto ICredentialProviderUserArray . Questo oggetto contiene un elenco di oggetti ICredentialProviderUser che possono essere sottoposti a query per ottenere informazioni sugli utenti che verranno enumerati. Ad esempio, è possibile ottenere rispettivamente il SID o il nome utente dell'utente usando GetStringValue con un parametro passato di PKEY_Identity_PrimarySid o PKEY_Identity_USerName . È anche possibile filtrare i risultati usando SetProviderFilter per visualizzare solo un subset di utenti disponibili.
L'uso di ICredentialProviderUserArray è facoltativo , ma è un modo pratico per ottenere le informazioni necessarie per rendere validi i valori SID. Per ottenere un elenco di utenti che verranno enumerati dall'interfaccia utente di accesso, implementare l'interfaccia ICredentialProviderSetUserArray per ottenere l'oggetto ICredentialProviderUserArray da SetUserArray. L'interfaccia utente di accesso chiama SetUserArray prima di GetCredentialCount, quindi l'oggetto ICredentialProviderUserArray è pronto quando un provider di credenziali restituisce le credenziali.
Un provider di credenziali V2 è rappresentato da un'icona visualizzata sotto il collegamento "Opzioni di accesso". Per fornire un'icona per il provider di credenziali, definire un CREDENTIAL_PROVIDER_FIELD_TYPE di CPFT_TILE_IMAGE nelle credenziali stesse. Assicurarsi quindi che il guidFieldTypedell'CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR sia impostato su CPFG_CREDENTIAL_PROVIDER_LOGO. Le dimensioni consigliate per un'icona sono 72 per 72 pixel.
Analogamente alla specifica di un'icona per il provider di credenziali, è anche possibile specificare una stringa di testo per identificare il provider di credenziali. Questa stringa viene visualizzata in una finestra popup quando un utente passa il puntatore del mouse sull'icona. A tale scopo, definire un CREDENTIAL_PROVIDER_FIELD_TYPE di CPFT_SMALL_TEXT nelle credenziali stesse. Assicurarsi quindi che il guidFieldTypedell'CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR sia impostato su CPFG_CREDENTIAL_PROVIDER_LABEL. Questa stringa deve integrare l'icona del provider di credenziali descritta in precedenza e essere sufficientemente descrittiva che gli utenti capiscono cosa è. Ad esempio, la descrizione del provider di password immagine è "Password immagine".
Quando implementare
Implementare questa interfaccia per associare riquadri delle credenziali a riquadri utente specifici nell'interfaccia utente di accesso.Requisiti
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | credentialprovider.h |