Fungsi PeerDistStartup (peerdist.h)

  • Artikel

Fungsi PeerDistStartup membuat handel instans Distribusi Serekan baru yang harus diteruskan ke semua API Distribusi Serekan lainnya.

Sintaks

DWORD PeerDistStartup(
  [in]            DWORD                     dwVersionRequested,
  [out]           PPEERDIST_INSTANCE_HANDLE phPeerDist,
  [out, optional] PDWORD                    pdwSupportedVersion
);

Parameter

[in] dwVersionRequested

Berisi versi minimum Distribusi Serekan yang diminta oleh aplikasi. Byte urutan tinggi menentukan nomor versi minor; byte urutan rendah menentukan nomor versi utama.

[out] phPeerDist

Penunjuk ke variabel PEERDIST_INSTANCE_HANDLE yang setelah berhasil menerima handel yang baru dibuat.

[out, optional] pdwSupportedVersion

Penunjuk ke variabel yang, jika bukan NULL, berisi nomor versi maksimum yang didukung oleh sistem Distribusi Serekan. Byte urutan tinggi menentukan nomor versi minor; byte urutan rendah menentukan nomor versi utama.

Nilai kembali

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.
PEERDIST_ERROR_VERSION_UNSUPPORTED
 Versi yang diminta tidak didukung oleh DLL sisi klien.

Keterangan

PeerDistStartup harus dipanggil sebelum fungsi Distribusi Serekan lainnya. Ketika tidak lagi diperlukan, handel yang dikembalikan oleh PeerDistStartup harus ditutup melalui panggilan ke PeerDistShutdown.

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

PeerDistShutdown