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

Статья
11/20/2024

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

Синтаксис

LONG SCardIntroduceReaderGroupW(
  [in] SCARDCONTEXT hContext,
  [in] LPCWSTR      szGroupName
);

Параметры

[in] hContext

Предоставляет дескриптор, определяющий контекст диспетчера ресурсов. Контекст диспетчера ресурсов задается предыдущим вызовом функции SCardEstablishContext. Если этот параметр NULL, область диспетчера ресурсов SCARD_SCOPE_SYSTEM.

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

Замечания

Функция SCardIntroduceReaderGroup предоставляется для совместимости спецификаций PC/SC. Группы читателя не хранятся, пока читатель не будет добавлен в группу.

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

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

Примеры

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

// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext, 
                                    L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceReaderGroup\n");

Заметка

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

Требования

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