Metode IVssBackupComponents::ExposeSnapshot (vsbackup.h)

Artikel
03/08/2023

Metode ExposeSnapshot mengekspos salinan bayangan sebagai huruf drive, folder yang dipasang, atau berbagi file.

Sintaks

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

Parameter

[in] SnapshotId

Pengidentifikasi salinan bayangan.

[in] wszPathFromRoot

Jalur ke bagian volume yang disediakan saat mengekspos salinan bayangan sebagai berbagi file. Nilai parameter ini harus NULL saat mengekspos salinan bayangan secara lokal; yaitu, mengeksposnya sebagai huruf kandar atau folder yang dipasang.

Jalur tidak boleh berisi variabel lingkungan (misalnya, %MyEnv%) atau karakter kartubebas.

Tidak ada persyaratan bahwa jalur berakhir dengan garis miring terbelakang (""). Terserah aplikasi yang mengambil informasi ini untuk diperiksa.

[in] lAttributes

Atribut salinan bayangan yang diekspos yang menunjukkan apakah itu terekspos secara lokal atau jarak jauh. Nilai harus berupa nilai VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY atau VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY_VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] wszExpose

Ketika salinan bayangan diekspos sebagai berbagi file, nilai parameter ini adalah nama berbagi. Jika salinan bayangan diekspos dengan memasangnya sebagai perangkat, nilai parameter adalah huruf drive diikuti oleh titik dua—misalnya, "X:" atau jalur folder yang dipasang (misalnya, "Y:\MountX"). Jika nilai parameter ini ADALAH NULL, maka VSS menentukan nama berbagi atau huruf drive jika parameter lAttributesVSS_VOLSNAP_ATTR_EXPOSED_REMOTELY.

[out] pwszExposed

Nama salinan bayangan yang diekspos. Ini adalah nama berbagi, huruf kandar diikuti oleh titik dua, atau folder yang dipasang. Nilainya adalah NULL jika ExposeSnapshot gagal. VSS mengalokasikan memori untuk string ini.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Salinan bayangan berhasil diekspos.
E_ACCESSDENIED	Pemanggil tidak memiliki hak 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	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	Salinan bayangan yang ditentukan tidak ada.
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

Pemanggil bertanggung jawab untuk membebaskan string yang dituju oleh parameter pwszExposed dengan memanggil fungsi CoTaskMemFree .

Saat mengekspos salinan bayangan persisten, salinan bayangan tetap terekspos melalui boot berikutnya.

Saat mengekspos salinan bayangan volume, salinan bayangan dapat diperlakukan baik sebagai perangkat yang dapat dipasang atau sebagai sistem file yang tersedia untuk berbagi file.

Ketika diekspos sebagai perangkat—seperti halnya perangkat lain yang dapat dipasang—salinan bayangan volume diekspos pada titik pemasangannya (huruf drive atau folder yang dipasang) dimulai dengan akarnya.

Ketika diekspos sebagai berbagi file, subset (ditunjukkan oleh wszPathFromRoot) volume dapat dibagikan.

Untuk informasi selengkapnya tentang cara mengekspos salinan bayangan, lihat Mengekspos dan Memunculkan Volume Yang Disalin Bayangan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [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::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Bagikan melalui