Función SCardCancel (winscard.h)

La función SCardCancel finaliza todas las acciones pendientes dentro de un contexto específico del administrador de recursos.

Las únicas solicitudes que se pueden cancelar son las que requieren la espera de una acción externa por parte del usuario o la tarjeta inteligente . Cualquier solicitud de acción pendiente finalizará con un estado que indique que se canceló la acción. Esto es especialmente útil para forzar que las llamadas de SCardGetStatusChange pendientes finalicen.

Sintaxis

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos. El contexto del administrador de recursos se establece mediante una llamada anterior a SCardEstablishContext.

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o se produce un error.

Código devuelto	Descripción
Success	SCARD_S_SUCCESS.
Error	Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

La función SCardCancel es una función de seguimiento de tarjetas inteligentes. Para obtener una descripción de otras funciones de seguimiento, consulte Funciones de seguimiento de tarjetas inteligentes.

Ejemplos

En el ejemplo siguiente se cancelan todas las acciones pendientes en el contexto especificado. En el ejemplo se supone que lReturn es una variable existente de tipo LONG y que hContext es un identificador válido recibido de una llamada anterior a SCardEstablishContext.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winscard.h
Library	Winscard.lib
Archivo DLL	Winscard.dll

Consulte también

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards