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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hContext

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

[in] szReaderName

Отображаемое имя удаляемого средства чтения.

[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	Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

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

Чтобы добавить средство чтения в группу читателей, используйте SCardAddReaderToGroup.

Примеры

В следующем примере показано, как удалить средство чтения из группы.

// Remove a reader from the group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
// The group is automatically forgotten if no readers remain in it.
lReturn = SCardRemoveReaderFromGroup(hContext, 
                                     L"MyReader",
                                     L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardRemoveReaderFromGroup\n");

Примечание

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

Требования


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