DsRestoreRegister 函式
[此函式可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 從 Windows Vista 開始，請改用 磁片區陰影複製服務 (VSS) 。]
DsRestoreRegister函式會註冊還原作業。此函式會連結所有後續的還原作業，並防止還原目標開始，直到呼叫DsRestoreRegisterComplete函式為止。
語法
HRESULT DsRestoreRegister(
_In_ HBC hbc,
_In_ LPCTSTR szCheckPointFilePath,
_In_ LPCTSTR szLogPath,
_In_ EDB_RSTMAP rgrstmap[],
_In_ LONG crstmap,
_In_ LPCTSTR szBackupLogPath,
_In_ ULONG genLow,
_In_ ULONG genHigh
);
參數
-
hbc [in]
-
包含使用 DsRestorePrepare 函式取得的還原內容控制碼。
-
szCheckPointFilePath [in]
-
Null 終止字串的指標，其中包含檢查點檔案的路徑。 此路徑是由 DsRestoreGetDatabaseLocations 函式提供，且 BFT 值為 BFT_CHECKPOINT_DIR。 這通常與系統資料庫路徑相同。 適當的備份還原函式需要此路徑。 此參數不可為 Null。 在此參數中傳遞 Null 會導致還原程式期間發生錯誤。
-
szLogPath [in]
-
Null 終止字串的指標，其中包含將還原記錄檔的路徑。 此路徑是由 DsRestoreGetDatabaseLocations 函式提供，且 BFT 值為 BFT_LOG_DIR。 如果路徑指向空的目錄，則會在該處建立新的記錄檔。 此參數不可為 Null。
-
rgrstmap [in]
-
EDB_RSTMAP結構的陣列，其中包含每個資料庫的舊路徑和新路徑。 每個資料庫都有一個結構。 針對目錄，有系統資料庫的結構，以及目錄資料庫的另一個結構。 陣列中元素的順序並不重要。 crstmap參數包含陣列中的元素數目。
-
crstmap [in]
-
包含 rgrstmap 陣列中的專案數目。
-
szBackupLogPath [in]
-
Null 終止字串的指標，其中包含備份記錄檔目前所在的路徑。 此參數不可為 Null。
-
genLow [in]
-
包含此還原會話中要還原的最低記錄號碼。 這是範圍從 0x00000 到 0xFFFFF 的十六進位數位。
-
genHigh [in]
-
包含此還原會話中要還原的最高記錄號碼。 這是範圍從 0x00000 到 0xFFFFF 的十六進位數位。
傳回值
如果函式成功或 Win32 或 RPC 錯誤碼，則傳回 S_OK 。 下列清單列出可能的錯誤碼。
-
ERROR_ACCESS_DENIED
-
呼叫端沒有適當的存取權限可呼叫此函式。 DsSetAuthIdentity函式可用來設定用於備份和還原函式的認證。
-
ERROR_INVALID_PARAMETER
-
一或多個參數無效。
-
hrMissingExpiryToken
-
提供給 DsRestorePrepare 的到期權杖無效。 此值定義于 Ntdsbmsg.h 中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|
| Unicode 與 ANSI 名稱 |
DsRestoreRegisterW (Unicode) 和 DsRestoreRegisterA (ANSI) |