Fungsi PeerDistServerOpenContentInformation (peerdist.h)

  • Artikel

Fungsi PeerDistServerOpenContentInformation membuka PEERDIST_CONTENTINFO_HANDLE. Klien menggunakan handel untuk mengambil informasi konten.

Sintaks

DWORD PeerDistServerOpenContentInformation(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
                 DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

Parameter

[in] hPeerDist

PEERDIST_INSTANCE_HANDLE yang dikembalikan oleh PeerDistStartup.

cbContentIdentifier

Panjangnya, dalam byte, dari pengidentifikasi konten.

[in] pContentIdentifier

Penunjuk ke buffer yang berisi pengidentifikasi konten.

ullContentOffset

Offset dari awal konten yang diterbitkan di mana penanganan informasi konten diminta.

cbContentLength

Panjang, dalam byte, konten (mulai dari ullContentOffset) yang informasi kontennya diminta.

[in, optional] hCompletionPort

Handel ke port penyelesaian yang digunakan untuk mengambil pemberitahuan penyelesaian fungsi asinkron. Untuk membuat port penyelesaian, gunakan fungsi CreateIoCompletionPort . Parameter ini bisa NULL.

[in, optional] ulCompletionKey

Nilai yang akan dikembalikan melalui parameter lpCompletionKey dari fungsi GetQueuedCompletionStatus . Parameter ini diabaikan ketika hCompletionPort adalah NULL.

[out] phContentInfo

Handel yang digunakan untuk mengambil informasi konten.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS. 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 tidak valid.
PEERDIST_ERROR_NOT_FOUND
 Data pengidentifikasi konten yang ditentukan tidak diterbitkan.
ERROR_ACCESS_DISABLED_BY_POLICY
 Fitur ini dinonaktifkan oleh Kebijakan Grup.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 Layanan tidak tersedia.

Keterangan

Jika fungsi berhasil, handel yang diterima oleh phContentInfo dapat diteruskan ke
Fungsi PeerDistServerRetrieveContentInformation untuk mengambil informasi konten. Handel harus ditutup melalui fungsi PeerDistServerCloseContentInformation .

Jika ullContentOffset dan cbContentLength keduanya nol, informasi konten untuk seluruh konten akan diambil.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 Professional [hanya 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

PeerDistServerRetrieveContentInformation