Função SCardDisconnect (winscard.h)

  • Artigo

A função SCardDisconnect encerra uma conexão aberta anteriormente entre o aplicativo de chamada e um cartão inteligente no leitor de destino.

Sintaxe

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

Parâmetros

[in] hCard

Valor de referência obtido de uma chamada anterior para SCardConnect.

[in] dwDisposition

Ação a ser tomada no cartão no leitor conectado no fechamento.

Valor Significado
SCARD_LEAVE_CARD
 Não faça nada especial.
SCARD_RESET_CARD
 Redefina o cartão.
SCARD_UNPOWER_CARD
 Desligue o cartão.
SCARD_EJECT_CARD
 Ejete o cartão.

Valor retornado

Essa função retorna valores diferentes dependendo se ela é bem-sucedida ou falha.

Código de retorno Descrição
Êxito
 SCARD_S_SUCCESS.
Falha
 Um código de erro. Para obter mais informações, consulte Valores retornados de cartão inteligente.

Comentários

Se um aplicativo (que anteriormente chamado de SCardConnect) for encerrado sem chamar SCardDisconnect, o cartão será redefinido automaticamente.

A função SCardDisconnect é uma função de acesso inteligente cartão e leitor. Para obter mais informações sobre outras funções de acesso, consulte Funções de acesso de cartão inteligente e leitor.

Exemplos

O exemplo a seguir encerra a conexão de cartão inteligente especificada. O exemplo pressupõe que lReturn é uma variável do tipo LONG e que hCardHandle é um identificador válido recebido de uma chamada anterior para SCardConnect.


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

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winscard.h
Biblioteca Winscard.lib
DLL Winscard.dll

Confira também

Scardconnect

SCardReconnect