Metode ISyncMgrHandlerInfo::GetComment (syncmgr.h)

Artikel
03/15/2023

Mendapatkan string yang berisi komentar mengenai handler.

Sintaks

HRESULT GetComment(
  [out] LPWSTR *ppszComment
);

Parameter

[out] ppszComment

Jenis: LPWSTR*

Ketika metode ini kembali, berisi penunjuk ke buffer yang berisi string komentar. String ini memiliki panjang maksimum MAX_SYNCMGR_NAME termasuk karakter null yang mengakhiri.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya. Jika metode gagal, ppszComment berisi string kosong.

Keterangan

String ini dapat disediakan oleh handler untuk menampilkan ringkasan konten kemitraan, misalnya "32 kontak" atau "13 lagu". String dapat memiliki panjang maksimum MAX_SYNCMGR_NAME termasuk karakter null yang mengakhiri.

Nilai komentar ditampilkan sebagai properti System.Sync.Comments (PKEY_Sync_Comments) di antarmuka pengguna folder saat sinkronisasi tidak dilakukan.

Pusat Sinkronisasi memanggil metode ini setiap kali metode UpdateHandler dipanggil.

Handler bertanggung jawab untuk mengalokasikan buffer string yang ditunjukkan oleh ppszComment melalui CoTaskMemAlloc. Sync Center membatalkan alokasi buffer string melalui CoTaskMemFree.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	syncmgr.h

Bagikan melalui