ICredentialProvider ::SetSerialization, méthode (credentialprovider.h)

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 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 requise. Il accepte des informations d’identification et détermine si pcpcs était une information d’identification partielle ou complète. S’il s’agit d’informations d’identification partielles, il est incomplet ou a été transmis pour afficher certaines informations à l’utilisateur. S’il s’agit d’une information d’identification complète, elle doit être sérialisée et envoyée. Utilisez les membres de l’CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION et les indicateurs passés dans SetUsageScenario pour déterminer comment gérer l’entrée. La responsabilité 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 le 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 lorsqu’une information d’identification d’entrée a été fournie par une application.

L’interface utilisateur d’informations d’identification applique les règles suivantes en fonction des dwFlags pour cette instance de fournisseur de contenu définie lorsque SetUsageScenario a été appelé.

• Si les indicateurs incluent CREDUIWIN_IN_CRED_ONLY, tous les fournisseurs d’informations d’identification retournant S_OK sont activés.
• Si les indicateurs incluent CREDUIWIN_AUTHPACKAGE_ONLY, tous les fournisseurs d’informations d’identification retournant un état de réussite sont activés.
• Si aucun de ces indicateurs n’est inclus, l’interface utilisateur d’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_SCENARIOCPUS_REDUI seront activés indépendamment de la valeur d’état retournée.

Spécifications