Metode ISCardTypeConv::CreateByteBuffer

[Metode CreateByteBuffer 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 CreateByteBuffer membuat buffer universal byte yang dipetakan ke dalam objek IStream (IByteBuffer).

Buffer byte yang dibuat adalah aliran yang dipetakan melalui blok memori. Untuk mengakses atau mengelola buffer, gunakan metode yang disediakan oleh antarmuka IStream . Fitur unik tentang implementasi array ini adalah bahwa ketika Anda memanggil metode IStream::Release , memori yang mendasar akan dirilis untuk Anda.

Sintaks

HRESULT CreateByteBuffer(
  [in]  DWORD        dwAllocSize,
  [out] LPBYTEBUFFER *ppbyBuff
);

Parameter

dwAllocSize [in]

Ukuran dalam byte memori yang akan dialokasikan untuk array.

ppbyBuff [out]

Penunjuk ke objek IStream yang akan dikembalikan.

Menampilkan nilai

Nilai yang mungkin dikembalikan adalah sebagai berikut:

Menampilkan kode	Deskripsi
S_OK	Memori berhasil dialokasikan.
E_INVALIDARG	Ada sesuatu yang salah dengan satu atau beberapa parameter yang diteruskan ke fungsi.
E_OUTOFMEMORY	Memori bebas tidak cukup untuk memenuhi permintaan.

 

Keterangan

Memori yang dialokasikan dapat dipindahkan. Gunakan metode IStream::Release untuk membebaskan memori.

Untuk membuat array byte C/C++ yang khas, panggil CreateByteArray.

Untuk membuat Automation SAFEARRAY dari karakter yang tidak ditandatangani (byte), panggil CreateSafeArray.

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_ISCardTypeConv didefinisikan sebagai 53B6AA63-3F56-11D0-916B-00AA00C18068

Lihat juga

ISCardTypeConv

Nilai Pengembalian Kartu Pintar

CreateByteArray

CreateSafeArray