Método ISCrdEnr::getUserName

O método getUserName recupera o nome do usuário em cujo nome o registro de certificado se destina.

Antes de chamar esse método, você deve especificar o nome de usuário em uma chamada para ISCrdEnr::selectUserName ou ISCrdEnr::setUserName.

Sintaxe

HRESULT getUserName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrUserName
);

SCrdEnr.getUserName( _
  ByVal dwFlags, _
  ByRef pbstrUserName _
)

Parâmetros

dwFlags [in]

Esse valor deve ser zero (0), SCARD_ENROLL_UPN_NAME ou SCARD_ENROLL_SAM_COMPATIBLE_NAME.

Se esse valor for SCARD_ENROLL_UPN_NAME, getUserName retornará o UPN (Nome Principal Universal) do usuário, como "someone@example.com".

Se esse valor for SCARD_ENROLL_SAM_COMPATIBLE_NAME, o método retornará o nome sam (gerenciador de acesso de segurança) do usuário no formato "DOMAIN\USER".

Se esse valor for zero, o método retornará o nome UPN do usuário se ele existir. Se o usuário não tiver um nome UPN, o método retornará o nome SAM do usuário.

pbstrUserName [out]

Um ponteiro para uma cadeia de caracteres que retorna o nome do usuário.

Valor retornado

C++

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.

VB

Cadeia de caracteres que representa o nome do usuário.

Comentários

Você pode especificar o nome do usuário para o qual o cartão inteligente é emitido chamando ISCrdEnr::setUserName ou 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::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName