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

Статья
08/27/2023

Функция SCardForgetCardType удаляет появившиеся смарт-карта из подсистемы интеллектуального карта.

Синтаксис

LONG SCardForgetCardTypeA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName
);

Параметры

[in] hContext

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

[in] szCardName

Отображаемое имя карта, удаляемого из базы данных смарт-карта.

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

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

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

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

Функция SCardForgetCardType является функцией управления базой данных. Дополнительные сведения о других функциях управления базами данных см. в разделе Функции управления базами данных смарт-карт.

Примеры

В следующем примере из системы удаляется указанный тип карта. В примере предполагается, что lReturn является допустимой переменной типа LONG, что hContext является допустимым дескриптором, полученным от предыдущего вызова функции SCardEstablishContext , а "MyCardName" ранее был представлен вызовом функции SCardIntroduceCardType .


lReturn = SCardForgetCardType(hContext, 
                              L"MyCardName");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetCardType\n");

Примечание

Заголовок winscard.h определяет SCardForgetCardType в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


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

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

SCardEstablishContext

SCardForgetReader

SCardForgetReaderGroup

SCardIntroduceCardType