Fungsi PeerDistServerPublishStream (peerdist.h)

Artikel
03/15/2023

Fungsi PeerDistServerPublishStream menginisialisasi aliran baru untuk diterbitkan ke layanan Distribusi Serekan.

Sintaks

DWORD PeerDistServerPublishStream(
  [in]           PEERDIST_INSTANCE_HANDLE       hPeerDist,
                 DWORD                          cbContentIdentifier,
  [in]           PBYTE                          pContentIdentifier,
                 ULONGLONG                      cbContentLength,
  [in, optional] PCPEERDIST_PUBLICATION_OPTIONS pPublishOptions,
  [in, optional] HANDLE                         hCompletionPort,
  [in, optional] ULONG_PTR                      ulCompletionKey,
  [out]          PPEERDIST_STREAM_HANDLE        phStream
);

Parameter

[in] hPeerDist

PEERDIST_INSTANCE_HANDLE yang dikembalikan oleh PeerDistStartup.

cbContentIdentifier

Panjang, dalam byte, dari buffer yang berisi data pengidentifikasi konten.

[in] pContentIdentifier

Penunjuk ke array yang berisi data pengidentifikasi konten.

cbContentLength

Panjang, dalam byte, dari konten yang akan diterbitkan. Nilai ini bisa 0 jika panjang konten belum diketahui. Jika argumen bukan nol disediakan, argumen tersebut harus cocok dengan total panjang data yang ditambahkan oleh panggilan fungsi PeerDistServerPublishAddToStream .

[in, optional] pPublishOptions

Penunjuk ke struktur PEERDIST_PUBLICATION_OPTIONS yang menentukan aturan penerbitan konten.

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phStream

Penunjuk yang menerima handel ke aliran yang digunakan untuk menerbitkan data ke dalam layanan Distribusi Serekan.

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	hPeerDist yang ditentukan tidak valid.
PEERDIST_ERROR_ALREADY_EXISTS	Pengidentifikasi konten yang digunakan untuk publikasi sudah diterbitkan.
ERROR_ACCESS_DISABLED_BY_POLICY	Fitur ini dinonaktifkan oleh Kebijakan Grup.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Layanan tidak tersedia.

Keterangan

Pengidentifikasi konten adalah label yang ditentukan pengguna untuk konten yang diterbitkan. Pengidentifikasi konten ini digunakan untuk panggilan PeerDistServerOpenContentInformation, PeerDistServerUnpublish, dan PeerDistServerCancelAsyncOperation .

Handel yang diterima oleh phStream dapat digunakan dalam PeerDistServerPublishAddToStream dan PeerDistServerPublishCompleteStream untuk menerbitkan data ke dalam layanan Distribusi Serekan. Handel ini harus ditutup oleh PeerDistServerCloseStreamHandle.

Publikasi hanya dapat diakses oleh Akun Pengguna yang awalnya menerbitkan konten. Jika pengguna yang berbeda memanggil PeerDistServerPublishStream dengan pengidentifikasi konten yang sama, publikasi terpisah akan dibuat di bawah konteks pengguna tersebut.

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