Метод ISCrdEnr::getUserName

  • Статья

Метод getUserName извлекает имя пользователя, от имени которого предназначена регистрация сертификата.

Перед вызовом этого метода необходимо указать имя пользователя в вызове ISCrdEnr::selectUserName или ISCrdEnr::setUserName.

Синтаксис

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


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

Параметры

dwFlags [in]

Это значение должно быть равно нулю (0), SCARD_ENROLL_UPN_NAME или SCARD_ENROLL_SAM_COMPATIBLE_NAME.

Если это значение равно SCARD_ENROLL_UPN_NAME, getUserName возвращает имя участника-пользователя, например "someone@example.com".

Если это значение равно SCARD_ENROLL_SAM_COMPATIBLE_NAME, метод возвращает имя диспетчера доступа (SAM) пользователя в формате DOMAIN\USER.

Если это значение равно нулю, метод возвращает имя участника-пользователя, если оно существует. Если у пользователя нет имени участника-пользователя, метод возвращает имя SAM пользователя.

pbstrUserName [out]

Указатель на строку, возвращающую имя пользователя.

Возвращаемое значение

C++

Если метод выполнен успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Строка, представляющая имя пользователя.

Комментарии

Можно указать имя пользователя, которому выдается смарт-карта, вызвав isCrdEnr::setUserName или ISCrdEnr::selectUserName. После указания имени пользователя его значение можно получить, вызвав метод getUserName.

Требования

Требование Значение
Минимальная версия клиента
 Ни одна версия не поддерживается
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Scrdenrl.dll
IID
 IID_ISCrdEnr определяется как 753988a1-1357-436d-9cf5-f089bd67d64

См. также раздел

ISCrdEnr

ISCrdEnr::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName