Метод 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 пользователя в формате DOMAIN\USER.

bstrUserName [in]

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

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

VB

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

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

Комментарии

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

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

Требования

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

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

ISCrdEnr

ISCrdEnr::getUserName

ISCrdEnr::resetUser

ISCrdEnr::selectUserName