Metodo ICredentialProvider::SetSerialization (credentialprovider.h)

  • Articolo

Imposta le caratteristiche di serializzazione del provider di credenziali.

Sintassi

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

Parametri

[in] pcpcs

Tipo: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Puntatore a una struttura CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION che archivia le caratteristiche di serializzazione del provider di credenziali.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo è obbligatorio. Accetta credenziali e determina se pcpcs è una credenziale parziale o completa. Se si tratta di credenziali parziali, è incompleta o è stata passata allo scopo di visualizzare alcune informazioni all'utente. Se si tratta di credenziali complete, deve essere serializzato e inviato. Usare i membri del CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION e i flag passati in SetUsageScenario per determinare come gestire l'input. La responsabilità è del provider di credenziali per verificare l'integrità dell'input. L'interfaccia utente delle credenziali e l'interfaccia utente di accesso non eseguono controlli sulla struttura prima di passarlo al provider di credenziali.

SetSerialization viene sempre chiamato dopo SetUsageScenario. L'interfaccia utente di accesso chiama anche SetSerialization quando un filtro restituisce credenziali tramite UpdateRemoteCredential. Questo metodo non viene usato per enumerare nuovamente i riquadri a causa di una chiamata a CredentialsChanged. L'interfaccia utente delle credenziali chiama SetSerialization quando una credenziale di input è stata sostituito da un'applicazione.

L'interfaccia utente delle credenziali applica le regole seguenti in base ai dwFlags per questa istanza del provider di contenuti definita quando è stato chiamato SetUsageScenario .

  • Se i flag includono CREDUIWIN_IN_CRED_ONLY, tutti i provider di credenziali che restituiscono S_OK sono abilitati.
  • Se i flag includono CREDUIWIN_AUTHPACKAGE_ONLY, tutti i provider di credenziali che restituiscono uno stato di esito positivo sono abilitati.
  • Se nessuno di questi flag è incluso, l'interfaccia utente delle credenziali segue la stessa logica dell'interfaccia utente di accesso e di tutti i provider di credenziali che implementano il CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI verranno abilitati indipendentemente dal valore di stato restituito.
I provider di credenziali che implementano un CREDENTIAL_PROVIDER_USAGE_SCENARIO di CPUS_LOGON e restituiscono un errore da questo metodo verranno comunque abilitati.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione credentialprovider.h