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

Статья
08/27/2023

Функция SCardForgetReader удаляет ранее появившиеся средства чтения из-под контроля подсистемы смарт-карта. Он удаляется из базы данных смарт-карта, в том числе из любой группы чтения, в которую она могла быть добавлена.

Синтаксис

LONG SCardForgetReaderA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szReaderName
);

Параметры

[in] hContext

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

[in] szReaderName

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

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

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

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

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

Примеры

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


lReturn = SCardForgetReader(hContext, 
                            TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetReader\n");

Примечание

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

Требования


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

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

SCardEstablishContext

SCardForgetCardType

SCardForgetReaderGroup

SCardIntroduceReader