Fungsi SCardSetAttrib (winscard.h)

  • Artikel

Fungsi SCardSetAttrib mengatur atribut pembaca yang diberikan untuk handel yang diberikan. Ini tidak mempengaruhi statuspembaca, driver pembaca, atau kartu pintar. Tidak semua atribut didukung oleh semua pembaca (juga tidak dapat diatur setiap saat) karena banyak atribut berada di bawah kendali langsung protokol transportasi.

Sintaks

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

Parameter

[in] hCard

Nilai referensi yang dikembalikan dari SCardConnect.

[in] dwAttrId

Pengidentifikasi untuk atribut yang akan diatur. Nilainya hanya menulis. Perhatikan bahwa vendor mungkin tidak mendukung semua atribut.

Nilai Makna
SCARD_ATTR_SUPRESS_T1_IFS_REQUEST
 Tekan pengiriman paket T=1 IFSD dari pembaca ke kartu. (Dapat digunakan jika kartu yang saat ini dimasukkan tidak mendukung permintaan IFSD.)

[in] pbAttr

Pointer ke buffer yang memasok atribut yang ID-nya disediakan dalam dwAttrId.

[in] cbAttrLen

Panjang (dalam byte) dari nilai atribut dalam buffer pbAttr .

Nilai kembali

Fungsi ini mengembalikan nilai yang berbeda tergantung pada apakah berhasil atau gagal.

Menampilkan kode Deskripsi
Berhasil
 SCARD_S_SUCCESS.
Kegagalan
 Kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Keterangan

Fungsi SCardSetAttrib adalah fungsi akses kartu langsung. Untuk informasi tentang fungsi akses langsung lainnya, lihat Fungsi Akses Kartu Langsung.

Contoh

Contoh berikut menunjukkan cara mengatur atribut.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winscard.h
Pustaka Winscard.lib
DLL Winscard.dll

Lihat juga

SCardConnect

SCardGetAttrib