Metode ISCardISO7816::ManageChannel

Artikel
06/13/2023

[Metode ManageChannel 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 ManageChannel membuat perintah unit data protokol aplikasi (APDU) yang membuka dan menutup saluran logis.

Fungsi terbuka membuka saluran logis baru selain yang dasar. Opsi disediakan agar kartu menetapkan nomor saluran logis, atau agar nomor saluran logis diberikan ke kartu.

Fungsi tutup secara eksplisit menutup saluran logis selain yang dasar. Setelah penutupan berhasil, saluran logis akan tersedia untuk digunakan kembali.

Sintaks

HRESULT ManageChannel(
  [in]      BYTE       byChannelState,
  [in]      BYTE       byChannel,
  [in, out] LPSCARDCMD *ppCmd
);

Parameter

byChannelState [in]

Bit b8 dari P1 digunakan untuk menunjukkan fungsi terbuka atau fungsi tutup; jika b8 adalah 0, maka KELOLA SALURAN akan membuka saluran logis dan jika b8 adalah 1, maka KELOLA SALURAN harus menutup saluran logis:

P1 = '00' untuk dibuka

P1 = '80' untuk ditutup

Nilai lainnya adalah RFU

byChannel [in]

Untuk fungsi terbuka (P1 = '00'), bit b1 dan b2 P2 digunakan untuk mengkodekan nomor saluran logis dengan cara yang sama seperti di byte kelas, bit P2 lainnya adalah RFU.

Ketika b1 dan b2 dari P2 adalah NULL, maka kartu akan menetapkan nomor saluran logis yang akan dikembalikan dalam bit b1 dan b2 bidang data.

Ketika b1 dan/atau b2 dari P2 bukan NULL, mereka mengkodekan nomor saluran logis selain yang dasar; kemudian kartu akan membuka nomor saluran logis yang ditetapkan secara eksternal.

ppCmd [masuk, keluar]

Pada input, penunjuk ke objek antarmuka ISCardCmd atau NULL.

Saat dikembalikan, perintah ini diisi dengan perintah APDU yang dibangun oleh operasi ini. Jika ppCmd diatur ke NULL, objek ISCardCmdkartu pintar dibuat secara internal dan dikembalikan menggunakan penunjuk ppCmd.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi selesai dengan sukses.
E_INVALIDARG	Parameter tidak valid.
E_POINTER	Penunjuk yang buruk diteruskan.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Ketika fungsi terbuka berhasil dilakukan dari saluran logis dasar, MF harus secara implisit dipilih sebagai DF saat ini dan status keamanan saluran logis baru harus sama dengan saluran logis dasar setelah ATR. Status keamanan saluran logis baru harus terpisah dari saluran logis lainnya.

Ketika fungsi terbuka berhasil dilakukan dari saluran logis, yang bukan yang dasar, DF saat ini dari saluran logis yang mengeluarkan perintah akan dipilih sebagai DF saat ini. Selain itu, status keamanan untuk saluran logis baru harus sama dengan status keamanan saluran logis tempat fungsi terbuka dilakukan.

Setelah berhasil menutup fungsi, status keamanan yang terkait dengan saluran logis ini hilang.

Untuk daftar semua metode yang disediakan oleh antarmuka ini, lihat ISCardISO7816.

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.

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	Scardssp.h
Pustaka jenis	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816 didefinisikan sebagai 53B6AA68-3F56-11D0-916B-00AA00C18068

Lihat juga

ISCardISO7816

Share via