Metode IVssCreateWriterMetadata::AddDatabaseFiles (vswriter.h)

  • Artikel

Metode AddDatabaseFiles menunjukkan kumpulan file (file atau file yang ditentukan) yang membentuk komponen database yang akan dicadangkan.

Sintaks

HRESULT AddDatabaseFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

Parameter

[in] wszLogicalPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi jalur logis komponen tempat database akan ditambahkan.

Untuk informasi selengkapnya, lihat Jalur Logis Komponen.

Jalur logis tidak diperlukan dan dapat berupa NULL.

[in] wszDatabaseName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama database.

Nama ini diperlukan dan harus sesuai dengan nama komponen tempat database ditambahkan.

[in] wszPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi jalur direktori yang berisi file database.

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

Jalur UNC didukung.

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 atau file yang terkait dengan database.

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

[in] dwBackupTypeMask

Masker bit (atau bitwise OR) dari nilai enumerasi VSS_FILE_SPEC_BACKUP_TYPE untuk menunjukkan apakah penulis harus mengevaluasi file untuk partisipasi dalam jenis operasi pencadangan tertentu.

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.
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.

Keterangan

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP, dan Windows Server 2003: Berbagi file jarak jauh tidak didukung hingga Windows 8 dan Windows Server 2012. Penulis hanya mendukung sumber daya lokal—kumpulan file yang jalur absolutnya dimulai dengan spesifikasi volume lokal yang valid dan tidak dapat menjadi drive jaringan yang dipetakan. Oleh karena itu, input jalur (wszPath) ke AddDatabaseFiles (setelah resolusi variabel lingkungan apa pun) harus dalam format ini.

Metode ini dapat dipanggil beberapa kali untuk database tertentu. Ini dilakukan ketika database ada pada file yang disimpan pada volume terpisah, seperti yang dimungkinkan dengan Microsoft SQL Server.

Nilai parameter wszLogicalPath dan wszDatabaseName harus cocok dengan salah satu komponen database yang sebelumnya ditambahkan dengan metode IVssCreateWriterMetadata::AddComponent .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent