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


Метод ISCardAuth::GetChallenge

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

Метод GetChallenge возвращает запрос из смарт-карта.

Синтаксис

HRESULT GetChallenge(
  [in, optional] LONG         lAlgoID,
  [in]           LONG         lLengthOfChallenge,
  [in]           LPBYTEBUFFER pParam,
  [in, out]      LPBYTEBUFFER *pBuffer
);

Параметры

lAlgoID [in, необязательный]

Алгоритм, используемый в процессе проверки подлинности.

lLengthOfChallenge [in]

Максимальная длина ожидаемого ответа.

pParam [in]

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

pBuffer [вход, выход]

При входе указывает на буфер.

В выходных данных содержит данные запроса из карта.

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

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

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

 

Комментарии

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

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

Требования

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

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

ISCardAuth