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


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

Функция SCardAddReaderTo Group добавляет чтения в группу чтения .

Синтаксис

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

Параметры

[in] hContext

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

Замечания

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

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

Примеры

В следующем примере показано, как добавить средство чтения смарт-карт в группу. В примере предполагается, что lReturn является существующей переменной типа LONG, что hContext является допустимым дескриптором, полученным из предыдущего вызова функции SCardEstablishContext, и что "MyReader" и "MyReaderGroup" известны системой с помощью предыдущих вызов ов функций SCardIntroduceReader и SCardIntroduceReaderGroup, соответственно.


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

Заметка

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

Требования

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

См. также

SCardEstablishContext

SCardIntroduceReader

SCardIntroduceReaderGroup

SCardRemoveReaderFromGroup