Metode ISCard::AttachByReader

[Metode AttachByReader tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini tidak tersedia untuk digunakan di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan yang lebih baru, Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. Modul Kartu Pintar menyediakan fungsionalitas serupa.]

Metode AttachByReader membuka kartu pintar di pembaca bernama.

Sintaks

HRESULT AttachByReader(
  [in] BSTR              bstrReaderName,
  [in] SCARD_SHARE_MODES ShareMode,
  [in] SCARD_PROTOCOLS   PrefProtocol
);

Parameter

bstrReaderName [in]

BSTR yang berisi nama pembaca kartu pintar.

ShareMode [in]

Mode untuk mengklaim akses ke kartu pintar.

Nilai	Makna
EKSKLUSIF	Tidak ada orang lain yang menggunakan koneksi ini ke kartu pintar.
BERSAMA	Aplikasi lain dapat menggunakan koneksi ini.

 

PrefProtocol [in]

Nilai protokol yang disukai.

T0

T1

RAW

T0| T1

Menampilkan nilai

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Buka pada kartu pintar di pembaca bernama telah berhasil diselesaikan.
E_INVALIDARG	Ada sesuatu yang salah dengan satu atau beberapa parameter yang diteruskan ke fungsi.

 

Keterangan

Selain kode kesalahan COM yang tercantum di atas, antarmuka ini dapat mengembalikan kode kesalahan kartu pintar jika fungsi kartu pintar dipanggil untuk menyelesaikan permintaan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Setelah Anda selesai menggunakan pembaca, lepaskan lampiran dengan memanggil metode ISCard::D etach .

Contoh

Contoh berikut menunjukkan melampirkan ke kartu pintar di pembaca kartu pintar tertentu.

#include <windows.h>
#include <stdio.h>
#include <Scardmgr.h>

// The reader name is vendor specific; change as needed.
#define READER_NAME L"Vendor Reader 0"

void main()
{
    BSTR     bstrReader = NULL;
    HRESULT  hr;

    bstrReader = SysAllocString(READER_NAME);
    if (NULL == bstrReader)
    {
        // Error encountered.
        exit(1);
    }

    // Connect to the reader.
    hr = pISCard->AttachByReader(bstrReader, SHARED, T0);
    if (FAILED(hr))
    {
        printf("Failed AttachByReader\n");
        // Take other error handling action.
        // ...
    }

    // Detach reader by calling ISCard::Detach (not shown).
    // ...

    // When done, free BSTR.
    if (NULL != bstrReader)
        SysFreeString(bstrReader);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP
Akhir dukungan server	Windows Server 2003
Header	Scardmgr.h
Pustaka jenis	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCard didefinisikan sebagai 1461AAC3-6810-11D0-918F-00AA00C18068

Lihat juga

AttachByHandle

Lepaskan

ISCard

Memasang Kembali