Bagikan melalui

Metode IPreviousVersionsInfo::AreSnapshotsAvailable (shobjidl.h)

  • Artikel

Kueri untuk ketersediaan gambar volume Windows Server 2003 yang direkam oleh sistem pada waktu sebelumnya.

Sintaks

HRESULT AreSnapshotsAvailable(
  [in]  LPCWSTR pszPath,
  [in]  BOOL    fOkToBeSlow,
  [out] BOOL    *pfAvailable
);

Parameter

[in] pszPath

Jenis: LPCWSTR

String Unicode yang dihentikan null yang berisi jalur yang sepenuhnya memenuhi syarat ke file atau folder pada volume yang dimaksud.

Catatan Hanya jalur ke file dan folder yang disimpan pada volume Windows Server 2003 yang saat ini didukung.
 

[in] fOkToBeSlow

Jenis: BOOL

Nilai boolean yang menentukan apakah server harus dihubungi untuk menentukan ketersediaan gambar volume yang disimpan. Untuk detail selengkapnya, lihat bagian Keterangan.

TRUE

Hubungi server jika hasilnya belum di-cache.

FALSE

Jangan hubungi server. Gunakan hasil yang di-cache sebagai gantinya.

[out] pfAvailable

Jenis: BOOL*

Penunjuk ke variabel boolean yang berisi hasilnya. Nilai ini hanya valid jika panggilan metode berhasil; jika tidak, itu tidak terdefinis.

TRUE

Setidaknya satu gambar volume yang disimpan di mana file atau folder bernama di pszPath tersedia.

FALSE

Tidak ada gambar volume yang disimpan.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan nilai kesalahan standar, termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode Deskripsi
S_OK
 Berhasil.
E_PENDING
 fOkToBeSlowadalah FALSE dan hasilnya saat ini tidak di-cache.

Keterangan

Jika IPreviousVersionsInfo::AreSnapshotsAvailable dipanggil pada file atau folder, hasilnya tidak menunjukkan bahwa informasi putar kembali tersedia untuk file atau folder tertentu, hanya bahwa rekam jepret dari seluruh volume tersedia. Hasil ini di-cache dan panggilan berikutnya yang menanyakan tentang apa pun yang disimpan pada volume yang sama mengakses hasil yang di-cache—dengan sedikit overhead performa—alih-alih mengontak ulang server.

Setelah respons server di-cache dalam memori, panggilan berikutnya tidak menghubungi server meskipun fOkToBeSlowTRUE. Jika fOkToBeSlowFALSE dan respons server belum di-cache dari panggilan sebelumnya, metode mengembalikan E_PENDING. Dalam hal ini, atur fOkToBeSlow ke TRUE dan panggil IPreviousVersionsInfo::AreSnapshotsAvailable lagi untuk menghubungi server.

Untuk performa yang lebih baik, utas UI yang memanggil metode ini harus selalu mengatur fOkToBeSlow ke FALSE. Jika metode mengembalikan E_PENDING, ikuti langkah-langkah ini.

  • Buat instans lain dari IPreviousVersionsInfo pada utas latar belakang.
  • Panggil IPreviousVersionsInfo::AreSnapshotsAvailable dengan fOkToBeSlow diatur ke TRUE.
  • Beri sinyal utas UI asli untuk memanggil IPreviousVersionsInfo::AreSnapshotsAvailable lagi. Hasilnya kemudian ditarik dari cache.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl.h
DLL Twext.dll (versi 5.2 atau yang lebih baru)