Metodo ISCrdEnr::setUserName

  • Articolo

Il metodo setUserName specifica il nome dell'utente per conto del quale è prevista la registrazione del certificato.

Sintassi

HRESULT setUserName(
  [in] DWORD dwFlags,
  [in] BSTR bstrUserName
);


SCrdEnr.setUserName( _
  ByVal dwFlags, _
  ByVal bstrUserName _
)

Parametri

dwFlags [in]

Questo valore deve essere SCARD_ENROLL_UPN_NAME (definito come 1) o SCARD_ENROLL_SAM_COMPATIBLE_NAME (definito come 2).

Impostare questo valore su SCARD_ENROLL_UPN_NAME, se il nome specificato in bstrUserName è il nome dell'entità universale dell'utente, ad esempio "someone@example.com". Il nome UPN dell'utente deve corrispondere a un nome SAM (Security Access Manager) esistente.

Impostare questo valore su SCARD_ENROLL_SAM_COMPATIBLE_NAME, se il nome specificato in bstrUserName è il nome SAM dell'utente nel formato "DOMAIN\USER".

bstrUserName [in]

Nome dell'utente.

Valore restituito

VB

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.

Commenti

Chiamare questo metodo per specificare il nome utente da emettere la smart card. Un'alternativa a setUserName è 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::getUserName

ISCrdEnr::resetUser

ISCrdEnr::selectUserName