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

Récupère les propriétés de chaîne de l’objet ICredentialProviderUser en fonction de la valeur d’entrée.

Syntaxe

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *stringValue
);

[in] key

Une des valeurs suivantes qui spécifie la propriété à récupérer.

REFPROPERTYKEY	Description	S’applique à...
PKEY_Identity_DisplayName	Nom d’utilisateur convivial.	Interface utilisateur de connexion et interface utilisateur d’informations d’identification
PKEY_Identity_LogonStatusString	Chaîne localisée qui indique que l’utilisateur est connecté à status.	Interface utilisateur de connexion uniquement
PKEY_Identity_PrimarySid	SID de l’utilisateur.	Interface utilisateur de connexion et interface utilisateur d’informations d’identification
PKEY_Identity_ProviderID	ID de fournisseur de l’utilisateur.	Interface utilisateur de connexion et interface utilisateur d’informations d’identification
PKEY_Identity_QualifiedUserName	Nom utilisé pour emballer une mémoire tampon d’authentification.	Interface utilisateur de connexion et interface utilisateur d’informations d’identification
PKEY_Identity_UserName	Nom d'utilisateur.	Interface utilisateur de connexion et interface utilisateur d’informations d’identification

[out] stringValue

Adresse d’un pointeur vers une mémoire tampon qui, lorsque cette méthode retourne correctement, reçoit la chaîne demandée.

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

Chacune de ces valeurs peut également être récupérée en tant que PROPVARIANT via ICredentialProviderUser ::GetValue.

Envisagez un scénario avec les utilisateurs suivants.

Utilisateur du domaine :
- Domaine : contoso
- Nom d’utilisateur : lisa
- Nom convivial : Lisa Andrews
Utilisateur local :
- Nom du PC : lisa-pc
- Nom d’utilisateur : lisa
- Nom convivial : Lisa Andrews
Compte Microsoft :
- Adresse e-mail : lisa@contoso.com
- Nom convivial : Lisa Andrews

Dans ce scénario, le tableau suivant fournit des exemples de données pour chacune des valeurs clés .

REFPROPERTYKEY	Utilisateur de domaine	Utilisateur local	Compte Microsoft
PKEY_Identity_DisplayName	« Lisa Andrews »	« Lisa Andrews »	« Lisa Andrews »
PKEY_Identity_LogonStatusString	« Connecté »	« Verrouillé »	« Connexion à distance à partir de lisa-pc »
PKEY_Identity_PrimarySid	« {S-1-5-21-227990834-2601404236-735077814-1001} »	« {S-1-5-21-227990834-2601404236-735077814-1001} »	« {S-1-5-21-227990834-2601404236-735077814-1001} »
PKEY_Identity_ProviderID	« {A198529B-730F-4089-B646-A12557F5665E} »	« {A198529B-730F-4089-B646-A12557F5665E} »	Non prédéfini
PKEY_Identity_QualifiedUserName	« contoso\lisa »	« lisa-pc\lisa »	«< nom du fournisseur de> compte »lisa@contoso.com
PKEY_Identity_UserName	« contoso\lisa »	« lisa »	"lisa@contoso.com"

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h
Bibliothèque	CredentialProvider.lib
DLL	Authui.dll