IVssEnumObject::Metode berikutnya (vss.h)

  • Artikel

Metode Berikutnya mengembalikan jumlah objek yang ditentukan dari daftar objek enumerasi yang ditentukan.

Sintaks

HRESULT Next(
  [in]  ULONG           celt,
  [out] VSS_OBJECT_PROP *rgelt,
  [out] ULONG           *pceltFetched
);

Parameter

[in] celt

Jumlah elemen yang akan dibaca dari daftar objek yang dijumlahkan ke dalam buffer rgelt .

[out] rgelt

Alamat buffer yang dialokasikan pemanggil yang menerima struktur celtVSS_OBJECT_PROP yang berisi objek yang dikembalikan. Parameter ini diperlukan dan tidak boleh NULL.

[out] pceltFetched

Jumlah elemen yang dikembalikan dalam buffer rgelt .

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Operasi berhasil.
S_FALSE
 Jumlah item yang dikembalikan kurang dari angka yang diminta.
E_FAIL
 Ada kesalahan internal dalam enumerator.
E_POINTER
 Salah satu parameter penunjuk yang diperlukan adalah NULL.

Keterangan

Saat meminta pengembalian lebih dari satu objek VSS_OBJECT_PROP , nilai pengembalian S_FALSE menunjukkan bahwa akhir daftar enumerasi telah tercapai. Jika lebih banyak objek diminta daripada yang tersisa dalam daftar, Berikutnya akan mengembalikan semua objek yang tersisa, mengatur parameter pceltFetched ke nilai bukan nol, dan mengembalikan S_FALSE.

Parameter rgelt output harus menunjuk ke array yang dialokasikan yang berisi struktur VSS_OBJECT_PROP celt, dan tidak boleh NULL.

Ini adalah tanggung jawab pemanggil untuk membebaskan sumber daya sistem yang dikembalikan oleh IVssEnumObject::Di samping struktur VSS_OBJECT_PROP yang ditujukkan oleh parameter rgelt .

Pemanggil harus menggunakan CoTaskMemFree untuk setiap nilai string dalam objek VSS_SNAPSHOT_PROP atau VSS_PROVIDER_PROP dalam struktur VSS_OBJECT_PROP yang dikembalikan.

Dalam kasus VSS_SNAPSHOT_PROP, ini dapat dilakukan secara manual, atau fungsi utilitas VssFreeSnapshotProperties dapat digunakan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vss.h
Pustaka VssApi.lib

Lihat juga

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP