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
SCARD_S_SUCCESS	Le paramètre hContext est valide.
ERROR_INVALID_HANDLE	Le paramètre hContext n’est pas valide.
Autres valeurs	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

SCardEstablishContext