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

Статья
03/13/2024

Функция SCardReconnect восстанавливает существующее подключение между вызывающим приложением и смарт-карта. Эта функция перемещает дескриптор карта из прямого доступа в общий или подтверждает и очищает условие ошибки, которое препятствует дальнейшему доступу к карта.

Синтаксис

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

Параметры

[in] hCard

Значение ссылки, полученное из предыдущего вызова SCardConnect.

[in] dwShareMode

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

Значение	Значение
SCARD_SHARE_SHARED	Это приложение будет совместно использовать эту карта с другими приложениями.
SCARD_SHARE_EXCLUSIVE	Это приложение не будет совместно использовать эту карта с другими приложениями.

[in] dwPreferredProtocols

Битовая маска допустимых протоколов для этого подключения. Возможные значения можно объединить с операцией ИЛИ .

Значение этого параметра должно включать текущий протокол. Попытка повторного подключения к протоколу, отличному от текущего, приведет к ошибке.

Значение	Значение
SCARD_PROTOCOL_T0	T=0 является допустимым протоколом.
SCARD_PROTOCOL_T1	T=1 является допустимым протоколом.

[in] dwInitialization

Тип инициализации, которая должна выполняться на карта.

Значение	Значение
SCARD_LEAVE_CARD	Не делайте ничего особенного при повторном подключении.
SCARD_RESET_CARD	Сброс карта (теплый сброс).
SCARD_UNPOWER_CARD	Выключите карта и сбросьте его (холодный сброс).

[out, optional] pdwActiveProtocol

Флаг, указывающий установленный активный протокол.

Значение	Значение
SCARD_PROTOCOL_T0	T=0 — активный протокол.
SCARD_PROTOCOL_T1	T=1 — активный протокол.

Возвращаемое значение

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

Код возврата	Описание
Успешно	SCARD_S_SUCCESS.
Failure	Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

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

Примеры

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

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

Требования

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

См. также раздел

SCardConnect

SCardDisconnect

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