Funzione SCardSetAttrib (winscard.h)

Articolo
03/09/2024

La funzione SCardSetAttrib imposta l'attributo lettore specificato per l'handle specificato. Non influisce sullo stato del lettore, del driver del lettore o della smart card. Non tutti gli attributi sono supportati da tutti i lettori (né possono essere impostati in qualsiasi momento) poiché molti degli attributi sono sotto controllo diretto del protocollo di trasporto.

Sintassi

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

Parametri

[in] hCard

Valore di riferimento restituito da SCardConnect.

[in] dwAttrId

Identificatore dell'attributo da impostare. I valori sono di sola scrittura. Si noti che i fornitori potrebbero non supportare tutti gli attributi.

Valore	Significato
SCARD_ATTR_SUPRESS_T1_IFS_REQUEST	Non inviare il pacchetto IFSD T=1 dal lettore alla scheda. Può essere usato se la scheda attualmente inserita non supporta una richiesta IFSD.

[in] pbAttr

Puntatore a un buffer che fornisce l'attributo il cui ID viene fornito in dwAttrId.

[in] cbAttrLen

Lunghezza (in byte) del valore dell'attributo nel buffer pbAttr .

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito	Descrizione
Success	SCARD_S_SUCCESS.
Operazioni non riuscite	Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card.

Commenti

La funzione SCardSetAttrib è una funzione di accesso diretto alla scheda. Per informazioni su altre funzioni di accesso diretto, vedere Funzioni di accesso diretto alle schede dirette.

Esempio

Nell'esempio seguente viene illustrato come impostare un attributo.

// 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");

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winscard.h
Libreria	Winscard.lib
DLL	Winscard.dll

Vedi anche

SCardConnect

SCardGetAttrib

Condividi tramite