Fonction SCardCancel (winscard.h)
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 |
|---|---|
|
SCARD_S_SUCCESS. |
|
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 |