Metodo ISCrdEnr::getUserName

  • Articolo

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
Scrdenrl.dll
IID
 IID_ISCrdEnr è definito come 753988a1-1357-436d-9cf5-f089bdd67d64

Vedi anche

ISCrdEnr

ISCrdEnr::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName