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

Статья
08/27/2023

Функция SCardDisconnect завершает подключение, ранее открытое между вызывающим приложением и смарт-карта в целевом средстве чтения.

Синтаксис

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

Параметры

[in] hCard

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

[in] dwDisposition

Действие для выполнения карта в подключенном средстве чтения при закрытии.

Значение	Значение
SCARD_LEAVE_CARD	Не делайте ничего особенного.
SCARD_RESET_CARD	Сбросьте карта.
SCARD_UNPOWER_CARD	Выключите карта.
SCARD_EJECT_CARD	Извлеките карта.

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

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

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

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

Примеры

В следующем примере завершается указанное подключение смарт-карта. В примере предполагается, что lReturn является переменной типа LONG, а hCardHandle — допустимым дескриптором, полученным при предыдущем вызове SCardConnect.


lReturn = SCardDisconnect(hCardHandle, 
                          SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardDisconnect\n");
    exit(1);  // Or other appropriate action.
}

Требования


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

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

SCardConnect

SCardReconnect

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