Fungsi PeerDistServerRetrieveContentInformation (peerdist.h)

Artikel
03/13/2024

Fungsi PeerDistServerRetrieveContentInformation mengambil informasi konten yang dikodekan yang terkait dengan handel yang dikembalikan oleh PeerDistServerOpenContentInformation.

Sintaks

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

Parameter

[in] hPeerDist

PEERDIST_INSTANCE_HANDLE yang dikembalikan oleh PeerDistStartup.

[in] hContentInfo

Handel yang dikembalikan oleh PeerDistServerOpenContentInformation.

cbMaxNumberOfBytes

Jumlah maksimum byte yang akan dibaca.

[in, out] pBuffer

Arahkan ke buffer yang menerima data informasi konten.

[in] lpOverlapped

Penunjuk ke struktur YANG TUMPANG TINDIH . Fungsi ini tidak memungkinkan penelepon untuk menentukan mulai Offset dalam konten. Offset secara implisit dipertahankan per hContentInfo. Offset dan OffsetHigh dicadangkan dan harus nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_IO_PENDING. Jika tidak, fungsi dapat mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
ERROR_INVALID_HANDLE	Handel hPeerDist atau hContentInfo tidak valid.
PEERDIST_ERROR_NO_MORE	EOF pada informasi konten telah tercapai.
ERROR_ACCESS_DISABLED_BY_POLICY	Fitur ini dinonaktifkan oleh Kebijakan Grup.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Layanan tidak tersedia.

Keterangan

Pada keberhasilan operasi PeerDistServerRetrieveContentInformation , bidang Offset dan OffsetHigh dari struktur YANG TUMPANG TINDIH akan diisi dengan offset ULONGLONG dalam informasi konten yang diambil. Anggota OffsetHigh akan diatur ke 32 bit offset yang lebih tinggi dan anggota Offset akan diatur ke 32 bit offset yang lebih rendah.

GetOverlappedResult akan mengisi lpNumberOfBytesTransferred dengan jumlah byte yang ditransfer. Jika pemanggil menggunakan port penyelesaian untuk memproses penyelesaian API Distribusi Serekan, argumen lpNumberOfBytes dari GetQueuedCompletionStatus akan diisi dengan jumlah byte yang ditransfer.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 Professional [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	peerdist.h
Pustaka	PeerDist.lib
DLL	PeerDist.dll

Lihat juga

PeerDistServerOpenContentInformation

PeerDistStartup