Функция SCardCancel (winscard.h)

  • Статья

Функция SCardCancel завершает все невыполненные действия в определенном контексте resource manager.

Единственные запросы, которые можно отменить, — это запросы, требующие ожидания внешних действий смарт-карта или пользователя. Все такие неоплаченные запросы на действия завершаются с указанием состояния, указывающего на то, что действие было отменено. Это особенно полезно для принудительного завершения вызовов SCardGetStatusChange .

Синтаксис

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Параметры

[in] hContext

Дескриптор, идентифицирующий контекст resource manager. Контекст диспетчера ресурсов задается при предыдущем вызове SCardEstablishContext.

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

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

Код возврата Описание
Успешно
 SCARD_S_SUCCESS.
Failure
 Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Комментарии

Функция SCardCancel является интеллектуальной функцией отслеживания карта. Описание других функций отслеживания см. в разделе Функции отслеживания смарт-карт.

Примеры

В следующем примере отменяется все невыполненные действия в указанном контексте. В примере предполагается, что lReturn — это существующая переменная типа LONG , а hContext — допустимый дескриптор, полученный при предыдущем вызове SCardEstablishContext.


lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winscard.h
Библиотека Winscard.lib
DLL Winscard.dll

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

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards