共用方式為


IVssCreateWriterMetadata::AddDatabaseFiles 方法 (vswriter.h)

AddDatabaseFiles 方法會指出檔案集 (指定的檔案或檔案) ,這些檔案會組成要備份的資料庫元件。

語法

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

參數

[in] wszLogicalPath

Null 終止寬字元字串的指標,其中包含將加入資料庫之元件的邏輯路徑。

如需詳細資訊,請參閱 元件的邏輯路徑

不需要邏輯路徑,而且可以是 NULL

[in] wszDatabaseName

包含資料庫名稱之 Null 終止寬字元字串的指標。

這是必要名稱,必須符合要加入資料庫之元件的名稱。

[in] wszPath

Null 終止寬字元字串的指標,其中包含包含資料庫檔案之目錄的路徑。

路徑可以包含環境變數 (例如%SystemRoot%) ,但不能包含通配符。

支援 UNC 路徑。

路徑結尾不需要反斜杠 (“”) 。 它由擷取這項資訊以檢查的應用程式決定。

[in] wszFilespec

Null 終止寬字元字串的指標,其中包含與資料庫相關聯之檔案的檔案規格。

例如,檔案規格不能包含目錄規格 (,沒有反斜杠) 但可以包含 ? 和 * 通配符。

[in] dwBackupTypeMask

位掩碼 (或位 OR 或 ) VSS_FILE_SPEC_BACKUP_TYPE 列舉值,以指出寫入器是否應該評估檔案,以參與特定類型的備份作業。

此自變數的預設值為 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED) 。

傳回值

以下是這個方法的有效傳回碼。

意義
S_OK
作業成功。
E_INVALIDARG
其中一個參數值無效。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT
XML 檔無效。 請檢查事件記錄檔以取得詳細數據。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理
VSS_E_OBJECT_NOT_FOUND
指定的元件不存在。
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 E_UNEXPECTED改用。

備註

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP 和 Windows Server 2003: 除非 Windows 8 和 Windows Server 2012,否則不支援遠端檔案共用。 寫入器僅支援本機資源—其絕對路徑以有效本機磁碟區規格開頭的檔案集合,而且不能是對應的網路驅動器機。 因此, (wszPath) 至 AddDatabaseFiles 的路徑輸入, (在解析任何環境變數之後,) 必須是此格式。

這個方法可以針對特定資料庫多次呼叫。 當資料庫存在於儲存在個別磁碟區上的檔案上時,Microsoft SQL Server 就有可能這麼做。

wszLogicalPathwszDatabaseName 參數的值應該符合先前使用 IVssCreateWriterMetadata::AddComponent 方法新增之其中一個資料庫元件的值。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent