Metode ISCardCmd::p ut_Data

[Metode put_Data 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 put_Data mengatur bidang data di unit data protokol aplikasi (APDU).

Sintaks

HRESULT put_Data(
  [in] LPBYTEBUFFER pData
);

Parameter

pData [in]

Penunjuk ke objek buffer byte (IStream) yang akan disalin ke bidang data APDU.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

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

 

Keterangan

Saat Anda mengatur bagian data baru dari pesan, panjang bidang data dihitung dan disimpan dalam parameter P3 APDU. Untuk mengambil panjang bidang data, panggil get_P3.

Untuk mengambil bidang data dari APDU, panggil get_Data.

Contoh

Contoh berikut menunjukkan cara mengatur bidang data di unit data protokol aplikasi (APDU). Contoh mengasumsikan bahwa pIByteData adalah penunjuk yang valid ke instans antarmuka IByteBuffer , dan bahwa pISCardCmd adalah penunjuk yang valid ke instans antarmuka ISCardCmd .

HRESULT    hr;

// pIByteData is a pointer to an instance of IByteBuffer.
// Set the data.
hr = pISCardCmd->put_Data(pIByteData);
if (FAILED(hr)) 
{
    printf("Failed put_Data.\n");
    // Take other error handling action as needed.
}

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	Scarddat.h
Pustaka jenis	Scarddat.tlb
DLL	Scardssp.dll
IID	IID_ISCardCmd didefinisikan sebagai D5778AE3-43DE-11D0-9171-00AA00C18068

Lihat juga

get_Data

get_P3

ISCardCmd