SCardIsValidContext, fonction (winscard.h)
La fonction SCardIsValidContext détermine si un handle de contexte de carte intelligent est valide.
Syntaxe
LONG SCardIsValidContext(
[in] SCARDCONTEXT hContext
);
Paramètres
[in] hContext
Handle qui identifie le contexte resource manager. Le contexte du gestionnaire de ressources peut être défini par un appel précédent à SCardEstablishContext.
Valeur retournée
Cette fonction retourne l’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
Le paramètre hContext est valide. |
|
Le paramètre hContext n’est pas valide. |
|
Code d'erreur. Pour plus d’informations, consultez Valeurs de retour de carte à puce. |
Remarques
Appelez cette fonction pour déterminer si un handle de contexte de carte intelligent est toujours valide. Une fois qu’un handle de contexte de carte intelligent a été défini par SCardEstablishContext, il peut devenir non valide si le service Resource Manager a été arrêté.
Exemples
L’exemple suivant montre comment déterminer si un handle de contexte de carte intelligent est valide.
// Check the smart card context handle.
// hContext was set previously by SCardEstablishContext.
LONG lReturn;
lReturn = SCardIsValidContext(hContext);
if ( SCARD_S_SUCCESS != lReturn )
{
// Function failed; check return value.
if ( ERROR_INVALID_HANDLE == lReturn )
printf("Handle is invalid\n");
else
{
// Some unexpected error occurred; report and bail out.
printf("Failed SCardIsValidContext - %x\n", lReturn);
exit(1); // Or other appropriate error action.
}
}
else
{
// Handle is valid; proceed as needed.
// ...
}
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour