Funzione SCardSetAttrib (winscard.h)

  • Articolo

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