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

Confira também

ISCrdEnr

ISCrdEnr::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName