Функция SCardAddReaderToGroupA (winscard.h)
Функция SCardAddReaderToGroup добавляет средство чтения в группу читателей.
Синтаксис
LONG SCardAddReaderToGroupA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName,
[in] LPCSTR szGroupName
);
Параметры
[in] hContext
Дескриптор, идентифицирующий контекст resource manager. Контекст диспетчера ресурсов задается при предыдущем вызове SCardEstablishContext. Этот параметр не может иметь значение NULL.
[in] szReaderName
Отображаемое имя добавляемого средства чтения.
[in] szGroupName
Отображаемое имя группы, в которую добавляется средство чтения.
Возвращаемое значение
Эта функция возвращает различные значения в зависимости от того, успешно или неудачно.
Код возврата | Описание |
---|---|
|
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 [только классические приложения] |
Целевая платформа | Windows |
Header | winscard.h |
Библиотека | Winscard.lib |
DLL | Winscard.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по