Fonction SCardSetCardTypeProviderNameA (winscard.h)
La fonction SCardSetCardTypeProviderName spécifie le nom du module (bibliothèque de liens dynamiques) contenant le fournisseur pour un nom carte et un type de fournisseur donnés.
Syntaxe
LONG SCardSetCardTypeProviderNameA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szCardName,
[in] DWORD dwProviderId,
[in] LPCSTR szProvider
);
Paramètres
[in] hContext
Handle qui identifie le contexte resource manager. Le contexte resource manager peut être défini par un appel précédent à SCardEstablishContext. Cette valeur peut être NULL si l’appel à SCardSetCardCardTypeProviderName n’est pas dirigé vers un contexte spécifique.
[in] szCardName
Nom du type carte auquel ce nom de fournisseur est associé.
[in] dwProviderId
Identificateur du fournisseur associé à ce type carte.
Valeur | Signification |
---|---|
|
La fonction récupère le nom du fournisseur de services principalde l’carte intelligente sous la forme d’une chaîne GUID. |
|
La fonction récupère le nom du fournisseur de services de chiffrement (CSP). |
|
La fonction récupère le nom du fournisseur de stockage de clés (KSP) smart carte. |
|
La fonction récupère le nom du module carte. |
[in] szProvider
Chaîne qui contient le nom du fournisseur qui représente le fournisseur csp.
Valeur retournée
Cette fonction retourne des valeurs différentes selon qu’elle réussit ou échoue.
Code de retour | Description |
---|---|
|
SCARD_S_SUCCESS. |
|
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 à l’intérieur d’une 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.
Cette fonction définit le nom du fournisseur, tandis que SCardGetCardCardTypeProviderName peut être utilisé pour récupérer le nom du fournisseur.
Exemples
L’exemple suivant montre comment spécifier le nom du fournisseur de type carte.
LPTSTR szNewProvName = _T("My Provider Name");
LPTSTR szCardName = _T("WindowsCard");
LONG lReturn = SCARD_S_SUCCESS;
// Set the card type provider name.
// hContext was set by SCardEstablishContext.
lReturn = SCardSetCardTypeProviderName(hContext,
szCardName,
SCARD_PROVIDER_CSP,
szNewProvName);
if ( SCARD_S_SUCCESS != lReturn )
{
printf("Failed SCardSetCardTypeProviderName - %x\n", lReturn);
exit(1);
}
Notes
L’en-tête winscard.h définit SCardSetCardTypeProviderName comme un 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. Le mélange 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
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
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