Fonction SCardCancel (winscard.h)

  • Article

La fonction SCardCancel met fin à toutes les actions en attente dans un contexte de gestionnaire de ressources spécifique.

Les seules demandes que vous pouvez annuler sont celles qui nécessitent l’attente d’une action externe de la part de l’carte ou de l’utilisateur intelligent. Toutes ces demandes d’action en suspens se terminent avec une status indication que l’action a été annulée. Cela est particulièrement utile pour forcer l’arrêt des appels SCardGetStatusChange en cours.

Syntaxe

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Paramètres

[in] hContext

Handle qui identifie le contexte resource manager. Le contexte resource manager est défini par un appel précédent à SCardEstablishContext.

Valeur retournée

Cette fonction retourne des valeurs différentes selon qu’elle réussit ou échoue.

Code de retour Description
Success
 SCARD_S_SUCCESS.
Échec
 Code d'erreur. Pour plus d’informations, consultez Valeurs de retour de carte à puce.

Remarques

La fonction SCardCancel est une fonction de suivi intelligente carte. Pour obtenir une description des autres fonctions de suivi, consultez Fonctions de suivi de carte à puce.

Exemples

L’exemple suivant annule toutes les actions en suspens dans le contexte spécifié. L’exemple suppose que lReturn est une variable existante de type LONG et que hContext est un handle valide reçu d’un appel précédent à SCardEstablishContext.


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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winscard.h
Bibliothèque Winscard.lib
DLL Winscard.dll

Voir aussi

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards