Metode IGetAppTrackerData::GetSuggestedPollingInterval (comsvcs.h)
Mengambil interval minimum untuk polling yang disarankan oleh Server Pelacak.
Sintaks
HRESULT GetSuggestedPollingInterval(
[out] DWORD *PollingIntervalInSeconds
);
Parameter
[out] PollingIntervalInSeconds
Interval polling yang disarankan Tracker Server, dalam hitungan detik.
Mengembalikan nilai
Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG dan S_OK.
Keterangan
Aplikasi yang menggunakan data pelacak biasanya perlu melakukan polling Pada Server Pelacak secara berkala untuk memastikan bahwa data ini sudah diperbarui. Misalnya, aplikasi administratif yang menampilkan data pelacakan kepada pengguna biasanya ingin data ini mendekati real-time. Namun, polling terlalu sering dapat menurunkan performa sistem secara keseluruhan. Perlu diingat juga bahwa aplikasi COM+ yang memperbarui data tidak segera mengirim pembaruan ke Tracker Server, jadi bahkan dalam kasus terbaik akan ada beberapa penundaan (biasanya hanya beberapa detik).
Frekuensi polling adalah kebijakan global yang dapat disesuaikan administrator, jika perlu, untuk menyeimbangkan antara kesegaran data dan dampak performa untuk serangkaian alat tertentu yang digunakan pada sistem yang mereka kelola. Nilai yang dikembalikan dalam PollingIntervalInSeconds adalah jumlah waktu minimum yang harus ditunggu aplikasi setelah mengambil data pelacakan sebelum melakukan panggilan lain untuk mengambil data yang sama. Aplikasi apa pun yang melakukan polling pada Server Pelacak harus memanggil metode ini dan menyesuaikan perilaku polling mereka.
Interval polling secara default sama dengan frekuensi peristiwa pelacakan (tiga detik). Nilai ini dapat disesuaikan dengan menulis nilai registri REG_DWORD berikut:
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3TrackingInfoPollingFrequency = interval polling minimum
Persyaratan
| Klien minimum yang didukung | Windows XP dengan SP2 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 dengan SP1 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | comsvcs.h |