Метод ISCrdEnr::setUserName

  • Статья

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

Синтаксис

HRESULT setUserName(
  [in] DWORD dwFlags,
  [in] BSTR bstrUserName
);


SCrdEnr.setUserName( _
  ByVal dwFlags, _
  ByVal bstrUserName _
)

Параметры

dwFlags [in]

Это значение должно быть либо SCARD_ENROLL_UPN_NAME (определяется как 1), либо SCARD_ENROLL_SAM_COMPATIBLE_NAME (определяется как 2).

Задайте для этого значения значение SCARD_ENROLL_UPN_NAME, если имя, указанное в параметре bstrUserName , является универсальным именем участника пользователя, например "someone@example.com". Имя участника-пользователя должно соответствовать существующему имени диспетчера доступа к безопасности (SAM).

Задайте для этого значения значение SCARD_ENROLL_SAM_COMPATIBLE_NAME, если имя, указанное в параметре bstrUserName , является именем SAM пользователя в формате "ДОМЕН\ПОЛЬЗОВАТЕЛЬ".

bstrUserName [in]

Имя пользователя.

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

VB

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

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

Комментарии

Вызовите этот метод, чтобы указать имя пользователя для выдачи смарт-карта. Альтернативой setUserName является ISCrdEnr::selectUserName.

После указания имени пользователя его значение можно получить, вызвав метод getUserName.

Требования

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

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

ISCrdEnr

ISCrdEnr::getUserName

ISCrdEnr::resetUser

ISCrdEnr::selectUserName