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
標頭	Ntdsbcli.h
程式庫	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Unicode 與 ANSI 名稱	DsRestoreRegisterW (Unicode) 和 DsRestoreRegisterA (ANSI)

另請參閱

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

還原 Active Directory

目錄備份函式