Função SCardCancel (winscard.h)

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.

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

Confira também

Scardestablishcontext

SCardGetStatusChange

SCardLocateCards