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

  • Статья

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

Комментарии

Если приложение (которое ранее называлось SCardConnect) завершает работу без вызова SCardDisconnect, карта сбрасывается автоматически.

Функция 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