ISCardLocate :: ConfigureCardNameSearch, méthode

[La méthode ConfigureCardNameSearch peut être utilisée dans les systèmes d’exploitation spécifiés dans la section relative à la configuration requise. elle n’est pas disponible pour une utilisation dans Windows server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. Les modules de carte à puce offrent des fonctionnalités similaires.]

La méthode ConfigureCardNameSearch spécifie les noms de carte à utiliser dans la recherche de la carte à puce.

Syntaxe

HRESULT ConfigureCardNameSearch(
  [in] LPSAFEARRAY pCardNames,
  [in] LPSAFEARRAY pGroupNames,
  [in] BSTR        bstrTitle,
  [in] LONG        lFlags
);

Paramètres

pCardNames [ dans]

Pointeur vers un tableau sécurisé Automation de noms de carte sous forme BSTR.

pGroupNames [ dans]

Pointeur vers un tableau sécurisé Automation des noms des groupes de cartes/lecteurs dans le formulaire BSTR à ajouter à la recherche.

bstrTitle [ dans]

Titre de la boîte de dialogue pour le contrôle commun de recherche.

lFlags [ dans]

Spécifie quand l' interface utilisateur est affichée.

Valeur Signification
_ _ interface utilisateur minimale SC DLG _
Affiche la boîte de dialogue uniquement si la carte recherchée par l’application appelante n’est pas localisée et peut être utilisée dans un lecteur. Cela permet de trouver la carte connectée (via un mécanisme de boîte de dialogue interne ou à l’aide des fonctions de rappel de l’utilisateur) et retournée à l’application appelante.
SC _ DLG _ non _ UI
N’affiche aucune interface utilisateur, quel que soit le résultat de la recherche.
_ _ interface utilisateur force SC DLG _
Provoque l’affichage de l’interface utilisateur, quel que soit le résultat de la recherche.

Valeur de retour

La méthode retourne l’une des valeurs possibles suivantes.

Code de retour Description
_OK
Opération exécutée avec succès.
E _ INVALIDARG
Paramètre non valide.
_pointeur E
Un pointeur incorrect a été passé dans pCardNames ou pGroupNames.
_OUTOFMEMORY E
Mémoire insuffisante.

Notes

Pour localiser la carte à puce, appelez FindCard.

Pour obtenir la liste de toutes les méthodes fournies par cette interface, consultez ISCardLocate.

Outre les codes d’erreur COM listés ci-dessus, cette interface peut retourner un code d’erreur de carte à puce si une fonction de carte à puce a été appelée pour terminer la demande. Pour plus d’informations, consultez valeurs de retour de carte à puce.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
Fin de la prise en charge des clients
Windows XP
Fin de la prise en charge des serveurs
Windows Server 2003
En-tête
Scardmgr. h
Bibliothèque de types
Scardmgr. tlb
DLL
Scardssp.dll
IID
IID _ ISCardLocate est défini en tant que 1461AACD-6810-11D0-918F-00AA00C18068

Voir aussi

FindCard

ISCardLocate