Funzione SCardSetAttrib (winscard.h)

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.

[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.

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

Vedi anche

SCardConnect

SCardGetAttrib