Metode IWSDInboundAttachment::Read (wsdattachment.h)

Artikel
03/04/2024

Mengambil data lampiran dari pesan yang dikirim oleh host jarak jauh.

Sintaks

HRESULT Read(
  [out] BYTE    *pBuffer,
  [in]  DWORD   dwBytesToRead,
  [out] LPDWORD pdwNumberOfBytesRead
);

Parameter

[out] pBuffer

Penunjuk ke buffer yang menerima data yang dibaca dari aliran lampiran. Program aplikasi bertanggung jawab untuk mengalokasikan dan membebaskan buffer data ini.

[in] dwBytesToRead

Ukuran buffer input pBuffer , dalam byte.

[out] pdwNumberOfBytesRead

Penunjuk ke DWORD yang berisi jumlah byte data yang dibaca dari aliran lampiran ke dalam buffer input pBuffer .

Mengembalikan nilai

Kemungkinan nilai pengembalian termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
S_FALSE	Akhir aliran lampiran telah tercapai.
E_INVALIDARG	pBuffer adalah NULL.
E_POINTER	pdwNumberofBytesRead adalah NULL.

Keterangan

Metode Baca memungkinkan aplikasi untuk menerima data arbitrer dari host jarak jauh dalam lampiran pesan yang dienkapsulasi MIME. WSDAPI akan menyediakan objek yang mengimplementasikan antarmuka ini ketika aliran lampiran diterima sebagai bagian dari pesan. Panggilan ke Baca membuka aliran lampiran masuk dan mentransfer data lampiran ke buffer aplikasi. Jika Read mengembalikan S_OK atau S_FALSE, pdwNumberofBytesRead diatur ke jumlah byte yang dibaca, yang mungkin kurang dari ukuran buffer. Panggilan Baca dapat memblokir lalu lintas jaringan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wsdattachment.h (termasuk Wsdapi.h)
DLL	Wsdapi.dll

Lihat juga

IWSDInboundAttachment

Bagikan melalui