Fungsi PeerCollabRegisterApplication (p2p.h)

Fungsi PeerCollabRegisterApplication mendaftarkan aplikasi dengan komputer lokal sehingga dapat diluncurkan dalam aktivitas kolaborasi serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

Parameter

[in] pcApplication

Penunjuk ke struktur PEER_APPLICATION_REGISTRATION_INFO yang berisi UUID set fitur aplikasi serekan serta data khusus serekan tambahan.

[in] registrationType

Nilai PEER_APPLICATION_REGISTRATION_TYPE yang menjelaskan apakah aplikasi serekan didaftarkan ke pengguna saat ini atau semua pengguna komputer serekan.

Nilai kembali

Mengembalikan S_OK jika fungsi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
E_OUTOFMEMORY
Memori tidak cukup untuk mendukung operasi ini.
E_INVALIDARG
Salah satu argumen tidak valid.

Keterangan

Aplikasi adalah sekumpulan fitur perangkat lunak atau perangkat lunak yang tersedia di titik akhir serekan. Umumnya, ini mengacu pada paket perangkat lunak yang mendukung aktivitas jaringan serekan, seperti game atau aplikasi kolaboratif lainnya.

Infrastruktur kolaborasi dapat menerima undangan aplikasi dari kontak tepercaya atau dari "Orang Near Me", yang didasarkan pada cakupan infrastruktur kolaborasi yang masuk dengan menggunakan PeerCollabSignin.

Aplikasi serekan memiliki GUID yang mewakili satu aplikasi tertentu. Ketika aplikasi terdaftar untuk serekan, GUID ini dan aplikasi yang sesuai dapat tersedia untuk semua kontak tepercaya dari serekan, yang menunjukkan aktivitas yang dapat diikuti serekan. Untuk membatalkan pendaftaran aplikasi serekan, panggil PeerCollabUnregisterApplication dengan GUID ini.

Saat mendaftarkan aplikasi, disarankan agar pengembang menentukan jalur relatif, seperti %ProgramFiles%, alih-alih jalur absolut. Ini mencegah kegagalan aplikasi karena perubahan lokasi file aplikasi. Misalnya, jika direktori C:\ProgramFiles dipindahkan ke E:\.

Hanya aplikasi lokal untuk mesin yang dapat didaftarkan. Tidak dimungkinkan untuk mendaftar ketika jalur yang dapat dieksekusi aplikasi terletak di berbagi jaringan seperti jalur UNC atau drive jaringan yang dipetakan secara lokal.

Aplikasi dapat didaftarkan dalam cakupan 'ALL_USERS' dan 'CURRENT_USER'. Jika aplikasi terdaftar di kedua cakupan secara bersamaan, aplikasi yang terdaftar dalam cakupan 'CURRENT_USER' lebih diutamakan daripada aplikasi yang terdaftar dalam cakupan 'ALL_USERS'. Penting untuk dicatat bahwa untuk mendaftar untuk jenis pendaftaran 'ALL_USERS' pemanggil harus beroperasi dengan hak istimewa admin.

Jumlah maksimum aplikasi yang dapat didaftarkan untuk registrationType tertentu adalah 64.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Tidak ada yang didukung
Target Platform Windows
Header p2p.h
Pustaka P2P.lib
DLL P2P.dll

Lihat juga

PEER_APPLICATION_REGISTRATION_TYPE

Fungsi API Kolaborasi Serekan

PeerCollabUnregisterApplication