Méthode ICredentialProvider ::SetSerialization (credentialprovider.h)

Article
08/22/2023

Définit les caractéristiques de sérialisation du fournisseur d’informations d’identification.

Syntaxe

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

Paramètres

[in] pcpcs

Type : const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Pointeur vers une structure de CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION qui stocke les caractéristiques de sérialisation du fournisseur d’informations d’identification.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode est obligatoire. Il accepte des informations d’identification et détermine si pcpcs était des informations d’identification partielles ou complètes . S’il s’agit d’informations d’identification partielles, elles sont incomplètes ou ont été transmises dans le but d’afficher certaines informations à l’utilisateur. S’il s’agit d’informations d’identification complètes, il doit être sérialisé et envoyé. Utilisez les membres du CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION et les indicateurs transmis dans SetUsageScenario pour déterminer comment gérer l’entrée. Il incombe au fournisseur d’informations d’identification de vérifier l’intégrité de l’entrée. L’interface utilisateur des informations d’identification et l’interface utilisateur d’ouverture de session n’effectuent aucune vérification sur la structure avant de la transmettre au fournisseur d’informations d’identification.

SetSerialization est toujours appelé après SetUsageScenario. L’interface utilisateur d’ouverture de session appelle également SetSerialization lorsqu’un filtre retourne des informations d’identification via UpdateRemoteCredential. Elle n’utilise pas cette méthode lors de la réinumation des vignettes en raison d’un appel à CredentialsChanged. L’interface utilisateur des informations d’identification appelle SetSerialization quand des informations d’identification d’entrée ont été remplies par une application.

L’interface utilisateur des informations d’identification applique les règles suivantes en fonction des dwFlags pour ce fournisseur de contenu instance définis lors de l’appel de SetUsageScenario.

Si les indicateurs incluent CREDUIWIN_IN_CRED_ONLY, tous les fournisseurs d’informations d’identification qui retournent S_OK sont activés.
Si les indicateurs incluent CREDUIWIN_AUTHPACKAGE_ONLY, tous les fournisseurs d’informations d’identification qui retournent une status réussie sont activés.
Si aucun de ces indicateurs n’est inclus, l’interface utilisateur des informations d’identification suit la même logique que l’interface utilisateur d’ouverture de session et tous les fournisseurs d’informations d’identification qui implémentent le CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI sont activés quelle que soit la valeur status retournée.

Les fournisseurs d’informations d’identification qui implémentent une CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON et retournent un échec à partir de cette méthode sont toujours activés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h

Partager via