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 |
|---|---|
|
Opération exécutée avec succès. |
|
Paramètre non valide. |
|
Un pointeur incorrect a été passé dans pCardNames ou pGroupNames. |
|
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 |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID _ ISCardLocate est défini en tant que 1461AACD-6810-11D0-918F-00AA00C18068 |