共用方式為

DsRestorePrepare 函式

  • 發行項

[此函式可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 從 Windows Vista 開始，請改用 磁片區陰影複製服務 (VSS) 。]

DsRestorePrepare函式會連線到指定的目錄伺服器，並準備進行還原作業。

語法

HRESULT DsRestorePrepare(
  _In_  LPCWSTR szServerName,
  _In_  ULONG   rtFlag,
  _In_  PVOID   pvExpiryToken,
  _In_  DWORD   cbExpiryTokenSize,
  _Out_ HBC     *phbc
);

參數

szServerName [in]

Null 終止字串的指標，其中包含要還原的伺服器名稱。 上述反斜線是選擇性的。 伺服器必須是呼叫此函式的相同電腦。 伺服器名稱不能包含任何底線 (_) 字元。 伺服器名稱的範例是 「\\server1」。

rtFlag [in]

指定要執行的還原類型。 這可以是零或下列其中一個值。

RESTORE_TYPE_CATCHUP

預設值。 還原的版本會透過標準對帳邏輯進行協調，讓還原的 DIT 可以與其他企業伺服器電腦同步處理。

RESTORE_TYPE_AUTHORATATIVE

不支援。

RESTORE_TYPE_ONLINE

不支援。 當 NTDS 上線時，就會執行還原。

pvExpiryToken [in]

與還原之備份相關聯的到期權杖指標。 備份目錄時，此權杖是從 DsBackupPrepare 函式取得。

如果此參數為 Null， phbc 中傳回的控制碼只能用來使用 DsRestoreGetDatabaseLocations 函式取得還原目錄。 控制碼不能用於任何其他還原函式。

cbExpiryTokenSize [in]

包含 pvExpiryToken中到期權杖的大小，以位元組為單位。

phbc [out]

接收還原控制碼的 HBC 值指標。 呼叫其他目錄服務還原函式時，會使用此控制碼，例如 DsBackupOpenFile 和 DsRestoreEnd。

傳回值

如果成功，則傳回標準 HRESULT 代碼;否則會傳回失敗碼。

備註

DsRestorePrepare函式要求呼叫端是伺服器上的 Administrators 群組成員。

DsRestorePrepare 可與或未提供權杖搭配使用。 如果提供權杖，則會檢查其是否到期，且傳回內容上允許所有作業。 如果未提供權杖，傳回的內容會受到限制，而且只能用於 DsRestoreGetDatabaseLocations 函 式。 它不能用於 DsRestoreRegister 函式。

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
標頭
Ntdsbcli.h
程式庫
Ntdsbcli.lib
DLL
Ntdsbcli.dll
Unicode 與 ANSI 名稱
 DsRestorePrepareW (Unicode) 和 DsRestorePrepareA (ANSI)

另請參閱

還原 Active Directory 伺服器

目錄備份函式

DsRestoreGetDatabaseLocations

DsRestoreRegister

DsRestoreRegisterComplete

DsRestoreEnd