Méthode ICredentialProviderCredential ::GetStringValue (credentialprovider.h)

Article
08/22/2023

Active la récupération de texte à partir d’informations d’identification avec un champ de texte.

Syntaxe

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

Paramètres

[in] dwFieldID

Type : DWORD

Identificateur du champ.

[out] ppsz

Type : LPWSTR*

Pointeur vers la mémoire contenant une chaîne Unicode terminée par null pour revenir à l’interface utilisateur d’ouverture de session ou à l’interface utilisateur 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 facultative.

L’interface utilisateur d’ouverture de session et l’interface utilisateur d’informations d’identification nous permettent d’obtenir la valeur pszLabel d’un champ. Ces informations sont nécessaires pour obtenir des valeurs pour les champs CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT et CPFT_PASSWORD_TEXT .

Meilleures pratiques pour les fournisseurs d’informations d’identification

Les fournisseurs d’informations d’identification gèrent les secrets utilisateur extrêmement sensibles afin de terminer les demandes d’ouverture de session et de déverrouillage. Comme bonne pratique, les informations secrètes telles que les mots de passe et les codes PIN 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 n’importe quel secret.
Ignorez rapidement les secrets de manière sécurisée une fois qu’ils sont utilisés.
Ignorez les secrets de manière sécurisée s’ils ne sont pas utilisés dans le but prévu dans un délai 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