Função SCardCancel (winscard.h)

  • Artigo

A função SCardCancel encerra todas as ações pendentes em um contexto específico do gerenciador de recursos.

As únicas solicitações que você pode cancelar são aquelas que exigem aguardar a ação externa pelo cartão inteligente ou pelo usuário. Quaisquer solicitações de ação pendentes serão encerradas com um status indicação de que a ação foi cancelada. Isso é especialmente útil para forçar o encerramento de chamadas SCardGetStatusChange pendentes.

Sintaxe

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Parâmetros

[in] hContext

Identificador que identifica o contexto do gerenciador de recursos. O contexto do gerenciador de recursos é definido por uma chamada anterior para SCardEstablishContext.

Retornar valor

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 do cartão inteligente.

Comentários

A função SCardCancel é uma função de controle de cartão inteligente. Para obter uma descrição de outras funções de acompanhamento, consulte Funções de acompanhamento de cartão inteligente.

Exemplos

O exemplo a seguir cancela todas as ações pendentes no contexto especificado. O exemplo pressupõe que lReturn é uma variável existente do tipo LONG e que hContext é um identificador válido recebido de uma chamada anterior para SCardEstablishContext.


lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

Requisitos

Requisito Valor
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

Scardestablishcontext

SCardGetStatusChange

SCardLocateCards