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.
| Código de retorno | Descrição |
|---|---|
|
SCARD_S_SUCCESS. |
|
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 |