Método ISCrdEnr::setUserName
O método setUserName especifica o nome do usuário em cujo nome o registro de certificado se destina.
Sintaxe
HRESULT setUserName(
[in] DWORD dwFlags,
[in] BSTR bstrUserName
);
SCrdEnr.setUserName( _
ByVal dwFlags, _
ByVal bstrUserName _
)
Parâmetros
-
dwFlags [in]
-
Esse valor deve ser SCARD_ENROLL_UPN_NAME (definido como 1) ou SCARD_ENROLL_SAM_COMPATIBLE_NAME (definido como 2).
Defina esse valor como SCARD_ENROLL_UPN_NAME, se o nome especificado em bstrUserName for o Nome da Entidade de Segurança Universal do usuário, como "someone@example.com". O nome UPN do usuário deve corresponder a um nome SAM (gerenciador de acesso de segurança) existente.
Defina esse valor como SCARD_ENROLL_SAM_COMPATIBLE_NAME, se o nome especificado em bstrUserName for o nome SAM do usuário no formato "DOMAIN\USER".
-
bstrUserName [in]
-
Nome do usuário.
Valor retornado
VB
Se o método for bem-sucedido, o método retornará S_OK.
Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
Comentários
Chame esse método para especificar o nome de usuário a ser emitido o cartão inteligente. Uma alternativa para setUserName é ISCrdEnr::selectUserName.
Depois que um nome de usuário for especificado, seu valor poderá ser recuperado chamando getUserName.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Nenhum compatível |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| DLL |
|
| IID |
IID_ISCrdEnr é definido como 753988a1-1357-436d-9cf5-f089bdd67d64 |
Confira também