Metodo ISCrdEnr::getUserName
Il metodo getUserName recupera il nome dell'utente per conto del quale è prevista la registrazione del certificato.
Prima di chiamare questo metodo, è necessario specificare il nome utente in una chiamata a ISCrdEnr::selectUserName o ISCrdEnr::setUserName.
Sintassi
HRESULT getUserName(
[in] DWORD dwFlags,
[out] BSTR *pbstrUserName
);
SCrdEnr.getUserName( _
ByVal dwFlags, _
ByRef pbstrUserName _
)
Parametri
-
dwFlags [in]
-
Questo valore deve essere zero (0), SCARD_ENROLL_UPN_NAME o SCARD_ENROLL_SAM_COMPATIBLE_NAME.
Se questo valore è SCARD_ENROLL_UPN_NAME, getUserName restituisce il nome entità universale dell'utente (UPN), ad esempio "someone@example.com".
Se questo valore è SCARD_ENROLL_SAM_COMPATIBLE_NAME, il metodo restituisce il nome sam (Security Access Manager) dell'utente nel formato "DOMAIN\USER".
Se questo valore è zero, il metodo restituisce il nome UPN dell'utente se esiste. Se l'utente non ha un nome UPN, il metodo restituisce il nome SAM dell'utente.
-
pbstrUserName [out]
-
Puntatore a una stringa che restituisce il nome dell'utente.
Valore restituito
C++
Se il metodo ha esito positivo, il metodo restituisce S_OK.
Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.
VB
Stringa che rappresenta il nome dell'utente.
Commenti
È possibile specificare il nome dell'utente a cui viene emessa la smart card chiamando ISCrdEnr::setUserName o ISCrdEnr::selectUserName. Dopo aver specificato un nome utente, il relativo valore può essere recuperato chiamando getUserName.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Nessuno supportato |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| DLL |
|
| IID |
IID_ISCrdEnr è definito come 753988a1-1357-436d-9cf5-f089bdd67d64 |
Vedi anche