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

Метод ISCardISO7816::Verify

  • Статья

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

Метод Verify создает команду единицы данных протокола приложения (APDU), которая инициирует сравнение (в карта) данных проверки, отправленных с устройства интерфейса, с эталонными данными, хранящимися в карта (например, паролем).

Синтаксис

HRESULT Verify(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Параметры

byRefCtrl [in]

Квантификатор ссылочных данных. Ниже приведено кодирование эталонного элемента управления P2.

Если текст пуст, команда может быть использована для получения числа "X" дальнейших разрешенных повторных попыток (SW1-SW2=63CX) или для проверка, не требуется ли проверка (SW1-SW2=9000).

Значение Значение
Нет сведений
 Битовое положение: 000000000
P2=00 зарезервирован, чтобы указать, что в карточках, где команда проверки однозначно ссылается на секретные данные, не используется конкретный квалификатор.
Глобальная ссылка
 Положение бита: 0-------
Примером глобального ссылки может быть пароль.
Конкретный ссылка
 Битовое положение: 1-------
Примером конкретного ссылки является пароль для DF.
RFU
 Положение бита: -xx-----
Ссылка на данные #
 Битовое положение: ---xxxxxx
Ссылочный номер данных может быть, например, номером пароля или коротким идентификатором EF.

 

pData [in]

Указатель на данные проверки. Этот параметр может принимать значение NULL. Значение по умолчанию — NULL.

ppCmd [in, out]

На входе — указатель на объект интерфейса ISCardCmd или NULL.

При возврате он заполняется командой APDU, созданной этой операцией. Если параметру ppCmd присвоено значение NULL, объект интеллектуальной картаISCardCmd создается внутренним образом и возвращается с помощью указателя ppCmd.

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

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

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

 

Комментарии

Состояние безопасности может быть изменено в результате сравнения. Неудачные сравнения могут быть записаны в карта (например, для ограничения числа дальнейших попыток использования эталонных данных).

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

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

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Окончание поддержки сервера
 Windows Server 2003
Заголовок
Scardssp.h
Библиотека типов
Scardsrv.tlb
DLL
Scardssp.dll
IID
 IID_ISCardISO7816 определяется как 53B6AA68-3F56-11D0-916B-00AA00C18068

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

ISCardISO7816