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

  • Статья

Функция SCardForgetReaderGroup удаляет ранее представленную группу смарт-картаreader из подсистемы интеллектуального карта. Хотя эта функция автоматически удаляет все средства чтения из группы, она не влияет на существование отдельных модулей чтения в базе данных.

Синтаксис

LONG SCardForgetReaderGroupA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szGroupName
);

Параметры

[in] hContext

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

[in] szGroupName

Отображаемое имя удаляемой группы читателей. Определяемые системой группы читателей не могут быть удалены из базы данных.

Значение Значение
SCARD_ALL_READERS
TEXT("SCard$AllReaders\000")
 Группа используется, если имя группы не указано при перечислении читателей. Возвращает список всех читателей независимо от того, в какой группе или группах находятся читатели.
SCARD_DEFAULT_READERS
TEXT("SCard$DefaultReaders\000")
 Группа по умолчанию, в которую добавляются все читатели при вводе в систему.
SCARD_LOCAL_READERS
TEXT("SCard$LocalReaders\000")
 Неиспользуемое устаревшее значение. Это управляемая внутри организации группа, которую нельзя изменить с помощью API-интерфейсов группы читателей. Он предназначен для использования только для перечисления.
SCARD_SYSTEM_READERS
TEXT("SCard$SystemReaders\000")
 Неиспользуемое устаревшее значение. Это управляемая внутри организации группа, которую нельзя изменить с помощью API-интерфейсов группы читателей. Он предназначен для использования только для перечисления.

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

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

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

Комментарии

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

Примеры

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


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

Примечание

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

Требования

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

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

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardIntroduceReaderGroup