IVssBackupComponents::Metode kueri (vsbackup.h)

Artikel
08/27/2023

Metode Kueri meminta penyedia pada sistem dan/atau salinan bayangan yang telah selesai dalam sistem yang berada dalam konteks saat ini. Metode ini hanya dapat dipanggil selama operasi pencadangan.

Sintaks

HRESULT Query(
  [in]  VSS_ID          QueriedObjectId,
  [in]  VSS_OBJECT_TYPE eQueriedObjectType,
  [in]  VSS_OBJECT_TYPE eReturnedObjectsType,
  [out] IVssEnumObject  **ppEnum
);

Parameter

[in] QueriedObjectId

Dicadangkan. Nilai parameter ini harus GUID_NULL.

[in] eQueriedObjectType

Menunjukkan pembatasan kueri ke jenis objek yang diberikan. Nilai VSS_OBJECT_NONE menunjukkan tidak ada batasan—yaitu, semua objek akan dikueri.

Saat ini, nilai parameter ini harus VSS_OBJECT_NONE.

[in] eReturnedObjectsType

Jenis objek yang akan dikembalikan. Nilai parameter ini harus VSS_OBJECT_SNAPSHOT atau VSS_OBJECT_PROVIDER.

[out] ppEnum

Dua arah tidak langsung ke objek enumerator IVssEnumObject .

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan pointer ke instans antarmuka IVssEnumObject .
E_ACCESSDENIED	Penelepon bukan administrator atau operator cadangan.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE	Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.
VSS_E_OBJECT_NOT_FOUND	Objek yang dikueri tidak ditemukan.
VSS_E_PROVIDER_VETO	Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_UNEXPECTED	Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Kesalahan penyedia tak terduga. Kode kesalahan dicatat dalam log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Karena Kueri hanya mengembalikan informasi tentang salinan bayangan yang telah selesai, satu-satunya status salinan bayangan yang dapat diungkapkannya adalah VSS_SS_COMPLETED.

Metode ini hanya dapat dipanggil selama operasi pencadangan dan harus didahului oleh panggilan ke IVssBackupComponents::InitializeForBackup dan IVssBackupComponents::SetContext.

Meskipun Kueri dapat mengembalikan informasi tentang semua penyedia yang tersedia di sistem, Kueri hanya akan mengembalikan informasi tentang salinan bayangan dengan konteks saat ini (diatur oleh IVssBackupComponents::SetContext). Misalnya, jika konteks _VSS_SNAPSHOT_CONTEXT diatur ke VSS_CTX_BACKUP, Kueri tidak akan mengembalikan informasi tentang salinan bayangan yang dibuat dengan konteks VSS_CTX_FILE_SHARE_BACKUP.

Meskipun metode ini saat ini mengembalikan daftar semua penyedia yang tersedia dan/atau semua salinan bayangan yang selesai, di masa mendatang, kueri khusus dapat didukung: misalnya, mengkueri semua salinan bayangan yang terkait dengan penyedia.

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	vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka	VssApi.lib

Lihat juga

IVssBackupComponents

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::SetContext

IVssEnumObject

Bagikan melalui