IVssCreateWriterMetadata：：AddDatabaseLogFiles 方法 (vswriter.h)
AddDatabaseLogFiles方法會指出與要備份之資料庫相關聯的記錄檔，以及其位置。
語法
HRESULT AddDatabaseLogFiles(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszDatabaseName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] DWORD dwBackupTypeMask
);
參數
[in] wszLogicalPath
Null終止寬字元字串的指標，其中包含將加入記錄檔之資料庫元件的邏輯路徑。
如需詳細資訊，請參閱 元件的邏輯路徑。
不需要邏輯路徑，而且可以是 Null。
[in] wszDatabaseName
以 Null結尾的寬字元字串指標，其中包含與記錄檔相關聯的資料庫元件名稱。 此元件的類型必須VSS_CT_DATABASE;否則，方法會傳回錯誤。
[in] wszPath
包含包含記錄檔之目錄路徑的 Null終止寬字元字串指標。
目錄可以是 VSS 電腦上的本機目錄，也可以是遠端檔案伺服器上的檔案共用目錄。
支援 UNC 路徑。
路徑可以包含環境變數 (，例如%SystemRoot%) ，但不能包含萬用字元。
路徑結尾不需要反斜線 (「」) 。 這是擷取此資訊以檢查的應用程式。
[in] wszFilespec
包含與資料庫相關聯之記錄檔檔案規格之 null終止寬字元字串的指標 (s) 。
例如，檔案規格不能包含目錄規格 (，沒有反斜線) 但可以包含 ？ 和 * 萬用字元。
[in] dwBackupTypeMask
位遮罩 (或位 OR 或) VSS_FILE_SPEC_BACKUP_TYPE 列舉值，以指出寫入器是否應該評估檔案以參與特定類型的備份作業。
此引數的預設值為 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED) 。
傳回值
以下是此方法的有效傳回碼。
| 值 | 意義 |
|---|---|
|
作業成功。 |
|
其中一個參數值無效，或呼叫端嘗試將資料庫檔案新增至非資料庫元件。 |
|
呼叫端記憶體不足或其他系統資源。 |
|
XML 檔無效。 請檢查事件記錄檔以取得詳細資料。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 |
|
指定的元件不存在。 |
|
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 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) 至 AddDatabaseLogFiles 的路徑輸入 (在解析任何環境變數之後，) 必須是此格式。
這個方法可以針對特定資料庫元件呼叫多次，當數個記錄檔儲存在不同的磁片區時，可能需要此方法。
wszLogicalPath和wszDatabaseName參數的值應該符合先前使用IVssCreateWriterMetadata：：AddComponent方法新增其中一個資料庫元件的值。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | vswriter.h (包括 Vss.h、VsWriter.h) |
| 程式庫 | VssApi.lib |