Metode IVssBackupComponents::SetContext (vsbackup.h)
Metode SetContext mengatur konteks untuk operasi terkait salinan bayangan berikutnya.
Sintaks
HRESULT SetContext(
[in] LONG lContext
);
Parameter
[in] lContext
Konteks yang akan diatur. Konteks harus merupakan salah satu nilai _VSS_SNAPSHOT_CONTEXT yang didukung atau masker bit yang didukung (atau bitwise OR) _VSS_VOLUME_SNAPSHOT_ATTRIBUTES dengan _VSS_SNAPSHOT_CONTEXT yang valid.
Menampilkan nilai
Nilai pengembalian default dari metode ini adalah S_OK. Berikut ini adalah kode pengembalian yang valid untuk metode ini.
Nilai | Makna |
---|---|
|
Berhasil mengatur konteks. |
|
Salah satu nilai parameter tidak valid. |
|
Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar. |
|
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. |
Keterangan
Konteks default untuk salinan bayangan VSS adalah VSS_CTX_BACKUP.
Windows XP: Satu-satunya konteks yang didukung adalah konteks default, VSS_CTX_BACKUP. Oleh karena itu, memanggil SetContext di bawah Windows XP mengembalikan E_NOTIMPL.
SetContext hanya dapat dipanggil sekali, dan harus dipanggil sebelum memanggil sebagian besar fungsi VSS.
Untuk detail tentang bagaimana konteks yang ditetapkan oleh IVssBackupComponents::SetContext memengaruhi cara salinan bayangan dibuat dan dikelola, lihat Detail Implementasi untuk Membuat Salinan Bayangan.
Untuk diskusi lengkap tentang konteks salinan bayangan yang diizinkan, lihat _VSS_SNAPSHOT_CONTEXT dan _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
Persyaratan
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::D oSnapshotSet
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk