SCardSetAttrib, fonction (winscard.h)

Article
03/04/2024

La fonction SCardSetAttrib définit l’attribut lecteur donné pour le handle donné. Cela n’affecte pas l’état du lecteur, du pilote de lecteur ou du carte intelligent. Tous les attributs ne sont pas pris en charge par tous les lecteurs (et ne peuvent pas être définis à tout moment), car un grand nombre d’attributs sont sous contrôle direct du protocole de transport.

Syntaxe

LONG SCardSetAttrib(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwAttrId,
  [in] LPCBYTE     pbAttr,
  [in] DWORD       cbAttrLen
);

Paramètres

[in] hCard

Valeur de référence retournée par SCardConnect.

[in] dwAttrId

Identificateur de l’attribut à définir. Les valeurs sont en écriture seule. Notez que les fournisseurs peuvent ne pas prendre en charge tous les attributs.

Valeur	Signification
SCARD_ATTR_SUPRESS_T1_IFS_REQUEST	Supprime l’envoi du paquet T=1 IFSD du lecteur vers le carte. (Peut être utilisé si le carte actuellement inséré ne prend pas en charge une demande IFSD.)

[in] pbAttr

Pointeur vers une mémoire tampon qui fournit l’attribut dont l’ID est fourni dans dwAttrId.

[in] cbAttrLen

Longueur (en octets) de la valeur d’attribut dans la mémoire tampon pbAttr .

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

La fonction SCardSetAttrib est une fonction d’accès direct carte. Pour plus d’informations sur les autres fonctions d’accès direct, consultez Fonctions d’accès direct à la carte.

Exemples

L’exemple suivant montre comment définir un attribut.

// Set the attribute.
// hCardHandle was set by a previous call to SCardConnect.
// dwAttrID is a DWORD value, specifying the attribute ID.
// pbAttr points to the buffer of the new value.
// cByte is the count of bytes in the buffer.
lReturn = SCardSetAttrib(hCardHandle,
                         dwAttrID,
                         (LPBYTE)pbAttr,
                         cByte);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardSetAttrib\n");

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

SCardConnect

SCardGetAttrib

Share via