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

Article
02/24/2024

Obtient le nombre d’informations d’identification disponibles sous ce fournisseur d’informations d’identification.

Syntaxe

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Paramètres

[out] pdwCount

Type : DWORD*

Pointeur vers une valeur DWORD qui reçoit le nombre d’informations d’identification.

[out] pdwDefault

Type : DWORD*

Pointeur vers une valeur DWORD qui reçoit l’index des informations d’identification à utiliser comme valeur par défaut. Si aucune valeur par défaut n’a été définie, cette valeur doit être définie sur CREDENTIAL_PROVIDER_NO_DEFAULT.

[out] pbAutoLogonWithDefault

Type : BOOL*

Pointeur vers une valeur BOOL indiquant si les informations d’identification par défaut identifiées par pdwDefault doivent être utilisées pour une tentative d’ouverture de session automatique. Une tentative d’ouverture de session automatique signifie que l’interface utilisateur d’ouverture de session ou d’informations d’identification appelle immédiatement GetSerialization sur la vignette par défaut du fournisseur.

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.

Lorsqu’une interface utilisateur d’ouverture de session ou d’informations d’identification est prête pour l’interaction utilisateur, une information d’identification par défaut est sélectionnée par défaut. Étant donné que chaque fournisseur d’informations d’identification fournit des informations d’identification par défaut, les règles suivantes déterminent si pdwDefault recevra le focus ou si les informations d’identification seront automatiquement connectées.

Si des informations d’identification par défaut ont déjà été spécifiées, que ces informations d’identification ne sont pas destinées à être utilisées pour l’ouverture de session automatique et que pdwDefault est utilisé pour l’ouverture de session automatique, pdwDefault est utilisé comme valeur par défaut.
Si pdwDefault provient du dernier fournisseur connecté et qu’il n’existe pas encore de valeur par défaut avec ouverture de session automatique, pdwDefault est utilisé comme valeur par défaut.
Si aucune valeur par défaut n’a été spécifiée, pdwDefault est utilisé comme valeur par défaut.

Si le nombre d’informations d’identification valides change, le fournisseur d’informations d’identification doit appeler CredentialsChanged sur le instance ICredentialProviderEvents fourni dans Advise.

Meilleures pratiques relatives aux fournisseurs d’informations d’identification

Les fournisseurs d’informations d’identification gèrent les secrets utilisateur extrêmement sensibles afin d’effectuer les demandes d’ouverture de session et de déverrouillage. En guise de meilleure pratique, les informations secrètes telles que les mots de passe et les codes confidentiels doivent être traitées avec le plus grand soin. Les techniques appropriées pour gérer les informations secrètes au sein d’un fournisseur d’informations d’identification sont les suivantes :

Ignorez toujours les secrets en toute sécurité. Pour ce faire, appelez SecureZeroMemory avant de libérer la mémoire utilisée pour contenir un secret.
Ignorez rapidement les secrets en toute sécurité une fois qu’ils sont utilisés.
Ignorez en toute sécurité les secrets s’ils ne sont pas utilisés à leur usage prévu dans un laps de temps prévu.

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