Metode IVssFileShareSnapshotProvider::SetContext (vsprov.h)

  • Artikel

Mengatur konteks untuk operasi terkait salinan bayangan berikutnya.

Sintaks

HRESULT SetContext(
  [in] LONG lContext
);

Parameter

[in] lContext

Konteks yang akan ditetapkan. Konteks harus merupakan salah satu nilai _VSS_SNAPSHOT_CONTEXT yang didukung atau kombinasi nilai _VSS_VOLUME_SNAPSHOT_ATTRIBUTES dan _VSS_SNAPSHOT_CONTEXT yang didukung.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Konteks berhasil disetel.
E_ACCESSDENIED
 Pemanggil tidak memiliki hak istimewa pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE
 Konteks dibekukan dan tidak dapat diubah.

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.

Untuk informasi selengkapnya tentang bagaimana konteks yang diatur oleh 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 8.1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform Windows
Header vsprov.h
Pustaka VssApi.lib

Lihat juga

IVssFileShareSnapshotProvider