IVssEnumObject::Metode berikutnya (vss.h)

Artikel
03/03/2024

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

Bagikan melalui