ISCrdEnr::getUserName, méthode
La méthode getUserName récupère le nom de l’utilisateur au nom duquel l’inscription du certificat est prévue.
Avant d’appeler cette méthode, vous devez spécifier le nom d’utilisateur dans un appel à ISCrdEnr::selectUserName ou ISCrdEnr::setUserName.
Syntaxe
HRESULT getUserName(
[in] DWORD dwFlags,
[out] BSTR *pbstrUserName
);
SCrdEnr.getUserName( _
ByVal dwFlags, _
ByRef pbstrUserName _
)
Paramètres
-
dwFlags [in]
-
Cette valeur doit être égale à zéro (0), SCARD_ENROLL_UPN_NAME ou SCARD_ENROLL_SAM_COMPATIBLE_NAME.
Si cette valeur est SCARD_ENROLL_UPN_NAME, getUserName renvoie le nom principal universel (UPN) de l’utilisateur, par exemple «someone@example.com ».
Si cette valeur est SCARD_ENROLL_SAM_COMPATIBLE_NAME, la méthode retourne le nom du gestionnaire d’accès de sécurité (SAM) de l’utilisateur au format « DOMAIN\USER ».
Si cette valeur est égale à zéro, la méthode retourne le nom UPN de l’utilisateur s’il existe. Si l’utilisateur n’a pas de nom UPN, la méthode retourne le nom SAM de l’utilisateur.
-
pbstrUserName [out]
-
Pointeur vers une chaîne qui retourne le nom de l’utilisateur.
Valeur retournée
C++
Si la méthode réussit, la méthode retourne S_OK.
Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
VB
Chaîne qui représente le nom de l’utilisateur.
Notes
Vous pouvez spécifier le nom de l’utilisateur auquel le carte intelligent est émis en appelant ISCrdEnr::setUserName ou ISCrdEnr::selectUserName. Une fois qu’un nom d’utilisateur a été spécifié, sa valeur peut être récupérée en appelant getUserName.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Aucun pris en charge |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| DLL |
|
| IID |
IID_ISCrdEnr est défini comme 753988a1-1357-436d-9cf5-f089bdd67d64 |
Voir aussi