Metode IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)

Artikel
03/08/2023

Menambahkan set file (file atau file tertentu) ke komponen grup file tertentu untuk penulis ekspres.

Sintaks

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

Parameter

[in] wszLogicalPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi jalur logis (yang mungkin NULL) dari komponen untuk menambahkan file. Untuk informasi selengkapnya, lihat Jalur Komponen Logis.

[in] wszGroupName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama komponen grup file. Jenis komponen ini harus VSS_CT_FILEGROUP; jika tidak, metode akan mengembalikan kesalahan.

[in] wszPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi direktori akar default file yang akan ditambahkan.

Jalur dapat berisi variabel lingkungan (misalnya, %SystemRoot%) tetapi tidak dapat berisi karakter kartubebas.

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

[in] wszFilespec

Penunjuk ke string karakter lebar yang dihentikan null yang berisi spesifikasi file file yang akan disertakan.

Spesifikasi file tidak boleh berisi spesifikasi direktori (misalnya, tidak ada garis miring terbelakang) tetapi dapat berisi ? dan * karakter kartubebas.

[in] bRecursive

Nilai Boolean yang menentukan apakah jalur yang ditentukan oleh parameter wszPath hanya mengidentifikasi satu direktori atau jika menunjukkan hierarki direktori yang akan dilalui secara rekursif. Parameter ini harus diatur ke true jika jalur diperlakukan sebagai hierarki direktori untuk diulang, atau salah sebaliknya.

Untuk informasi tentang melintasi folder yang dipasang, lihat Bekerja dengan Folder yang Dipasang dan Titik Pemilahan Ulang.

[in] wszAlternateLocation

Parameter ini dicadangkan dan harus NULL.

[in] dwBackupTypeMask

Bitmask nilai enumerasi VSS_FILE_SPEC_BACKUP_TYPE untuk menunjukkan apakah penulis harus mengevaluasi file untuk partisipasi dalam jenis operasi pencadangan tertentu.

Parameter ini tidak dapat mencakup VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED, atau VSS_FSBT_LOG_BACKUP_REQUIRED.

Nilai default untuk argumen ini adalah (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Operasi berhasil.
E_INVALIDARG	Salah satu nilai parameter tidak valid, atau pemanggil mencoba menambahkan file grup file ke komponen non-grup file.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT	Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_OBJECT_NOT_FOUND	Komponen yang ditentukan tidak ada.
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.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka	VssApi.lib

Lihat juga

IVssCreateExpressWriterMetadata

Bagikan melalui