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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hContext

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

[in] szCardName

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

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

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

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

Замечания

Эта функция не перенаправляется, но вызов функции 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winscard.h
библиотеки	Winscard.lib
DLL	Winscard.dll

См. также

SCardEstablishContext

SCardForgetReader

SCardForgetReaderGroup

SCardIntroduceCardType

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