SCardListInterfacesW, fonction (winscard.h)

Article
08/27/2023

La fonction SCardListInterfaces fournit une liste d’interfaces fournies par un carte donné.

L’appelant fournit le nom d’une carte intelligente précédemment introduite dans le sous-système et reçoit la liste des interfaces prises en charge par le carte.

Syntaxe

LONG SCardListInterfacesW(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCWSTR      szCard,
  [out]     LPGUID       pguidInterfaces,
  [in, out] LPDWORD      pcguidInterfaces
);

Paramètres

[in] hContext

Handle qui identifie le contexte resource manager pour la requête. Le contexte du gestionnaire de ressources peut être défini par un appel précédent à SCardEstablishContext. Ce paramètre ne peut pas être NULL.

[in] szCard

Nom du carte intelligent déjà introduit dans le sous-système smart carte.

[out] pguidInterfaces

Tableau d’identificateurs d’interface (GUID) qui indiquent les interfaces prises en charge par le carte intelligent. Si cette valeur est NULL, SCardListInterfaces ignore la longueur de tableau fournie dans pcguidInterfaces, en retournant la taille du tableau qui aurait été retournée si ce paramètre n’avait pas été NULL à pcguidInterfaces et un code de réussite.

[in, out] pcguidInterfaces

Taille du tableau pcguidInterfaces et reçoit la taille réelle du tableau retourné. Si la taille du tableau est spécifiée en tant que SCARD_AUTOALLOCATE, pcguidInterfaces est converti en pointeur en pointeur GUID et reçoit l’adresse d’un bloc de mémoire contenant le tableau. Ce bloc de mémoire doit être libéré avec SCardFreeMemory.

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

Cette fonction n’est pas redirigée, mais l’appel de la fonction lors d’une tentative de session Bureau à distance n’entraîne pas d’erreur. Cela signifie uniquement que le résultat provient de l’ordinateur distant au lieu de l’ordinateur local.

La fonction SCardListInterfaces est une fonction de requête de base de données. Pour plus d’informations sur les autres fonctions de requête de base de données, consultez Fonctions de requête de base de données de carte à puce.

Exemples

L’exemple suivant montre la liste des interfaces d’un carte intelligent.

LPGUID          pGuids = NULL;
LONG            lReturn;
DWORD           cGuid = SCARD_AUTOALLOCATE;

// Retrieve the list of interfaces.
lReturn = SCardListInterfaces(NULL,
                              (LPCSTR) "MyCard",
                              (LPGUID)&pGuids,
                              &cGuid );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardListInterfaces\n");
    exit(1);   // Or other appropriate action
}

if ( 0 != cGuid )
{
    // Do something with the array of Guids.
    // Remember to free pGuids when done (by SCardFreeMemory).
    // ...
}

Notes

L’en-tête winscard.h définit SCardListInterfaces en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


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