Поделиться через

Метод ISCardVerify::ChangeCode

  • Статья

[Метод ChangeCode доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Модули смарт-карт предоставляют аналогичные функциональные возможности.]

Метод ChangeCode заменяет текущий код CHV (карта проверки владельца) новым кодом CHV.

Синтаксис

HRESULT ChangeCode(
  [in] LPBYTEBUFFER pOldCode,
  [in] LPBYTEBUFFER pNewCode,
  [in] SCARD_FLAGS  Flags,
  [in] LONG         lRef
);

Параметры

pOldCode [in]

Указатель на IByteBuffer , содержащий текущий код пользователя.

pNewCode [in]

Указатель на IByteBuffer, содержащий новый код, который будет представлен смарт-карта в процессе изменения для проверки подлинности пользователя.

Флаги [в]

Указывает, является ли код глобальным или локальным, а также должен ли он быть включен или отключен.

SC_FL_IHV_GLOBAL

SC_FL_IHV_LOCAL

SC_FL_IHV_ENABLE

SC_FL_IHV_DISABLE

lRef [in]

Смарт-карта конкретный справочник.

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

Метод возвращает одно из следующих возможных значений:

Код возврата Описание
S_OK
 Operation completed successfully (Операция выполнена успешно).
E_INVALIDARG
 Недопустимый параметр.
E_POINTER
 Был передан неправильный указатель.
E_OUTOFMEMORY
 Недостаточно памяти.

 

Комментарии

Список всех методов, определенных этим интерфейсом, см. в разделе ISCardVerify.

В дополнение к приведенным выше кодам ошибок COM этот интерфейс может возвращать код ошибки смарт-карта, если для выполнения запроса была вызвана функция смарт-карта. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Окончание поддержки сервера
 Windows Server 2003

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

IByteBuffer

ISCardVerify

Возвращаемые значения смарт-карты