ISCrdEnr::setUserName, méthode
La méthode setUserName spécifie le nom de l’utilisateur pour lequel l’inscription du certificat est prévue.
Syntaxe
HRESULT setUserName(
[in] DWORD dwFlags,
[in] BSTR bstrUserName
);
SCrdEnr.setUserName( _
ByVal dwFlags, _
ByVal bstrUserName _
)
Paramètres
-
dwFlags [in]
-
Cette valeur doit être SCARD_ENROLL_UPN_NAME (définie comme 1) ou SCARD_ENROLL_SAM_COMPATIBLE_NAME (définie comme 2).
Définissez cette valeur sur SCARD_ENROLL_UPN_NAME, si le nom spécifié dans bstrUserName est le nom de principal universel de l’utilisateur, par exemple «someone@example.com ». Le nom UPN de l’utilisateur doit correspondre à un nom de gestionnaire d’accès de sécurité (SAM) existant.
Définissez cette valeur sur SCARD_ENROLL_SAM_COMPATIBLE_NAME, si le nom spécifié dans bstrUserName est le nom SAM de l’utilisateur au format « DOMAIN\USER ».
-
bstrUserName [in]
-
Nom de l'utilisateur.
Valeur retournée
VB
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.
Notes
Appelez cette méthode pour spécifier le nom d’utilisateur à émettre le carte intelligent. Une alternative à setUserName est 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