OPENCARDNAMEA, structure (winscard.h)
La structure OPENCARDNAME contient les informations que la fonction GetOpenCardName utilise pour initialiser une boîte de dialogue Sélectionner une carte carte intelligente. Il est recommandé d’appeler SCardUIDlgSelectCard avec OPENCARDNAME_EX plutôt que d’appeler GetOpenCardName avec OPENCARDNAME. OPENCARDNAME est fourni à des fins de compatibilité descendante.
Syntaxe
typedef struct {
DWORD dwStructSize;
HWND hwndOwner;
SCARDCONTEXT hSCardContext;
LPSTR lpstrGroupNames;
DWORD nMaxGroupNames;
LPSTR lpstrCardNames;
DWORD nMaxCardNames;
LPCGUID rgguidInterfaces;
DWORD cguidInterfaces;
LPSTR lpstrRdr;
DWORD nMaxRdr;
LPSTR lpstrCard;
DWORD nMaxCard;
LPCSTR lpstrTitle;
DWORD dwFlags;
LPVOID pvUserData;
DWORD dwShareMode;
DWORD dwPreferredProtocols;
DWORD dwActiveProtocol;
LPOCNCONNPROCA lpfnConnect;
LPOCNCHKPROC lpfnCheck;
LPOCNDSCPROC lpfnDisconnect;
SCARDHANDLE hCardHandle;
} OPENCARDNAMEA, *POPENCARDNAMEA, *LPOPENCARDNAMEA;
Membres
dwStructSize
Spécifie la longueur, en octets, de la structure. Ce membre ne doit pas être NULL.
hwndOwner
Fenêtre qui possède la boîte de dialogue. Ce membre peut être n’importe quel handle de fenêtre valide, ou il peut être NULL pour le bureau par défaut.
hSCardContext
Contexte utilisé pour la communication avec le gestionnairede ressources smart carte. Appelez SCardEstablishContext pour définir le contexte resource manager et SCardReleaseContext pour le libérer. Ce membre ne doit pas être NULL.
lpstrGroupNames
Pointeur vers une mémoire tampon qui contient des chaînes de nom de groupe terminées par null. La dernière chaîne de la mémoire tampon doit être terminée par deux caractères Null. Chaque chaîne est le nom d’un groupe de cartes qui doit être inclus dans la recherche. Si lpstrGroupNames a la valeur NULL, le groupe par défaut (Scard$DefaultReaders) est recherché.
nMaxGroupNames
Nombre maximal d’octets (version ANSI) ou de caractères (version Unicode ) dans la chaîne lpstrGroupNames .
lpstrCardNames
Pointeur vers une mémoire tampon qui contient des chaînes de nom de carte terminées par null. La dernière chaîne de la mémoire tampon doit être terminée par deux caractères Null. Chaque chaîne est le nom d’un carte qui doit être localisé.
nMaxCardNames
Nombre maximal d’octets (version ANSI) ou de caractères (version Unicode ) dans la chaîne lpstrCardNames .
rgguidInterfaces
Réservé pour un usage futur. Défini sur NULL. Tableau de GUID qui identifient les interfaces requises.
cguidInterfaces
Réservé pour une utilisation à terme. Défini sur NULL. Nombre d’interfaces dans le tableau rgguidInterfaces .
lpstrRdr
Si le carte se trouve, la mémoire tampon lpstrRdr contient le nom du lecteur qui contient le carte situé. La mémoire tampon doit comporter au moins 256 caractères.
nMaxRdr
Taille, en octets (version ANSI) ou caractères (version Unicode ), de la mémoire tampon pointée par lpstrRdr. Si la mémoire tampon est trop petite pour contenir les informations du lecteur, GetOpenCardName retourne SCARD_E_NO_MEMORY et la taille requise de la mémoire tampon pointée vers lpstrRdr.
lpstrCard
Si le carte se trouve, la mémoire tampon lpstrCard contient le nom du carte situé. La mémoire tampon doit comporter au moins 256 caractères.
nMaxCard
Taille, en octets (version ANSI) ou caractères (version Unicode ), de la mémoire tampon pointée par lpstrCard. Si la mémoire tampon est trop petite pour contenir les informations de carte, GetOpenCardName retourne SCARD_E_NO_MEMORY et la taille requise de la mémoire tampon dans nMaxCard.
lpstrTitle
Pointeur vers une chaîne à placer dans la barre de titre de la boîte de dialogue. Si ce membre a la valeur NULL, le système utilise le titre par défaut « Sélectionner la carte : ».
dwFlags
Ensemble d’indicateurs de bits que vous pouvez utiliser pour initialiser la boîte de dialogue. Lorsque la boîte de dialogue est retournée, elle définit ces indicateurs pour indiquer l’entrée de l’utilisateur. Ce membre peut être une combinaison des indicateurs suivants.
Valeur | Signification |
---|---|
|
Affiche la boîte de dialogue uniquement si le carte recherché par l’application appelante n’est pas localisé et peut être utilisé dans un lecteur. Cela permet aux carte d’être trouvés, connectés (via le mécanisme de boîte de dialogue interne ou les fonctions de rappel utilisateur) et retournés à l’application appelante. |
|
Ne pas forcer l’affichage de l’interface utilisateurSélectionner une carte, quel que soit le résultat de la recherche. |
|
Forcer l’affichage de l’interface utilisateur sélectionner la carte , quel que soit le résultat de la recherche. |
pvUserData
Pointeur void vers les données utilisateur. Ce pointeur est repassé à l’appelant sur les routines Connect, Check et Disconnect.
dwShareMode
Si lpfnConnect n’a pas la valeur NULL, les membres dwShareMode et dwPreferredProtocols sont ignorés.
Si lpfnConnect a la valeur NULL et que dwShareMode est différent de zéro, un appel interne est effectué à SCardConnect qui utilise dwShareMode et dwPreferredProtocols comme paramètres dwShareMode et dwPreferredProtocols . Si la connexion réussit, hCardHandle est défini sur le handle retourné par hSCardConnect.
Si lpfnConnect a la valeur NULL et que dwShareMode est égal à zéro, la boîte de dialogue retourne hCardHandle comme NULL.
dwPreferredProtocols
Utilisé pour la connexion interne, comme décrit dans dwShareMode.
dwActiveProtocol
Retourne le protocole réel en cours d’utilisation lorsque la boîte de dialogue établit une connexion à un carte.
lpfnConnect
Pointeur vers la routine de connexion carte de l’appelant. Si l’appelant doit effectuer un traitement supplémentaire pour se connecter à l’carte, ce pointeur de fonction est défini sur la fonction de connexion de l’utilisateur. Si la fonction de connexion réussit, le carte reste connecté et initialisé, et le handle carte est retourné.
Le prototype de la routine de connexion est le suivant.
Connect(
hSCardContext, // the card context passed in the parameter block
szReader, // the name of the reader
mszCards, // multiple string that contains the
// possible card names in the reader
pvUserData // pointer to user data passed in parameter block
);
lpfnCheck
Pointeur vers le carte vérifier la routine de l’appelant. Si aucune vérification carte spéciale n’est requise, ce pointeur a la valeur NULL.
Si la carte est rejetée par la routine de vérification, FALSE est retourné et le carte est déconnecté, comme indiqué par lpfnDisconnect.
Si le carte est accepté par la routine de vérification, TRUE est retourné. Lorsque l’utilisateur accepte le carte, toutes les autres cartes actuellement connectées sont déconnectées, comme indiqué par lpfnDisconnect, et cette carte est retournée en tant que carte situé. Le carte situé reste connecté.
Le prototype de la routine case activée est le suivant.
Check(
hSCardContext, // the card context passed in the parameter block
hCard, // card handle
pvUserData // pointer to user data passed in the parameter block
);
lpfnDisconnect
Pointeur vers la routine de déconnexion carte de l’appelant.
Le prototype de la routine de déconnexion est le suivant.
Disconnect(
hSCardContext, // the card context passed in the parameter block
hCard, // card handle
pvUserData // pointer to user data passed in the parameter block
);
hCardHandle
Handle du carte connecté (via une connexion de boîte de dialogue interne ou un rappel lpfnConnect).
Remarques
Notes
L’en-tête winscard.h définit OPENCARDNAME 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] |
En-tête | winscard.h |
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