Interfaccia ICredentialProvider (credentialprovider.h)
Espone i metodi utilizzati nella configurazione e nella manipolazione di un provider di credenziali. Tutti i provider di credenziali devono implementare questa interfaccia.
Ereditarietà
L'interfaccia ICredentialProvider eredita dall'interfaccia IUnknown . ICredentialProvider include anche questi tipi di membri:
Metodi
L'interfaccia ICredentialProvider include questi metodi.
| ICredentialProvider::Advise Consente a un provider di credenziali di avviare eventi nell'interfaccia utente di accesso o nell'interfaccia utente delle credenziali tramite un'interfaccia di callback. |
| ICredentialProvider::GetCredentialAt Ottiene una credenziale specifica. |
| ICredentialProvider::GetCredentialCount Ottiene il numero di credenziali disponibili in questo provider di credenziali. |
| ICredentialProvider::GetFieldDescriptorAt Ottiene i metadati che descrivono un campo specificato. |
| ICredentialProvider::GetFieldDescriptorCount Recupera il numero di campi nell'oggetto necessario per visualizzare le credenziali del provider. |
| ICredentialProvider::SetSerialization Imposta le caratteristiche di serializzazione del provider di credenziali. |
| ICredentialProvider::SetUsageScenario Definisce gli scenari per i quali il provider di credenziali è valido. Chiamato ogni volta che viene inizializzato il provider di credenziali. |
| ICredentialProvider::UnAdvise Usato dall'interfaccia utente di accesso o dall'interfaccia utente delle credenziali per consigliare al provider di credenziali che i callback degli eventi non sono più accettati. |
Commenti
Questa interfaccia consente di interagire con l'interfaccia utente di accesso e l'interfaccia utente delle credenziali per l'app.
Un provider di credenziali di cui è stata creata un'istanza viene gestito per l'intera durata di un'interfaccia utente di accesso. Per questo motivo, l'interfaccia utente di accesso può mantenere lo stato di un provider di credenziali. In particolare, ricorda quale provider e riquadro ha fornito una credenziale. Ciò significa che è possibile archiviare informazioni sullo stato quando si usa un CREDENTIAL_PROVIDER_USAGE_SCENARIO di CPUS_LOGON, CPUS_UNLOCK_WORKSTATION e CPUS_CHANGE_PASSWORD. Questo non è il caso dell'interfaccia utente delle credenziali. L'interfaccia utente delle credenziali crea una nuova istanza del provider ogni volta che un'applicazione chiama CredUIPromptForWindowsCredentials. Per questo motivo, l'interfaccia utente delle credenziali non può ricordare lo stato di un provider di credenziali.
Tenere presente che un CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION generato in uno scenario può essere salvato e usato in uno scenario di utilizzo successivo. Per questo motivo, è necessario assicurarsi che l'implementazione di ICredentialProvider sia abbastanza affidabile per gestire questo scenario.
Windows 8 aggiunge nuove funzionalità nell'API dei provider di credenziali, principalmente la possibilità di raggruppare le credenziali in base all'utente.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | credentialprovider.h |
Vedi anche
CREDENTIAL_PROVIDER_USAGE_SCENARIO
Esperienza di accesso a Windows basata sul provider di credenziali