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 pelo 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
Scrdenrl.dll
IID
IID_ISCrdEnr é definido como 753988a1-1357-436d-9cf5-f089bdd67d64

Confira também

ISCrdEnr

ISCrdEnr::getUserName

ISCrdEnr::resetUser

ISCrdEnr::selectUserName