Функция SCardAddReaderToGroupW (winscard.h)
Функция
Синтаксис
LONG SCardAddReaderToGroupW(
[in] SCARDCONTEXT hContext,
[in] LPCWSTR szReaderName,
[in] LPCWSTR szGroupName
);
Параметры
[in] hContext
Дескриптор, определяющий контекст диспетчера ресурсов . Контекст диспетчера ресурсов задается предыдущим вызовом 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 [только классические приложения] |
целевая платформа | Виндоус |
заголовка | winscard.h |
библиотеки |
Winscard.lib |
DLL | Winscard.dll |