Metode IVssBackupComponents::SetContext (vsbackup.h)

  • Artikel

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
S_OK
 Berhasil mengatur konteks.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
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_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.

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

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::StartSnapshotSet

_VSS_SNAPSHOT_CONTEXT

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES