Fungsi PeerCollabAddContact (p2p.h)
Fungsi PeerCollabAddContact menambahkan kontak ke daftar kontak serekan.
Sintaks
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
Parameter
[in] pwzContactData
Penunjuk ke buffer string Unicode yang dihentikan nol yang berisi data kontak untuk peer yang ditambahkan ke daftar kontak. Buffer string ini dapat diperoleh dengan meneruskan nama serekan titik akhir untuk ditambahkan sebagai kontak ke PeerCollabQueryContactData, atau melalui mekanisme out-of-band.
Untuk mengirim data kontaknya sendiri di luar band, peer dapat memanggil PeerCollabExportContact dengan nama peer NULL . Fungsi ini mengembalikan data kontak dalam format XML.
[out, optional] ppContact
Penunjuk ke penunjuk ke struktur PEER_CONTACT . Parameter ini menerima alamat struktur PEER_CONTACT yang berisi informasi kontak serekan untuk kontak yang disediakan dalam pwzContactData. Parameter ini mungkin NULL.
Panggil PeerFreeData pada alamat struktur PEER_CONTACT untuk membebaskan data ini.
Mengembalikan nilai
Mengembalikan S_OK jika fungsi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Memori tidak cukup untuk mendukung operasi ini. |
|
Salah satu argumen tidak valid. |
Persyaratan
| 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 |