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 |
標頭 |
|
程式庫 |
|
DLL |
|
Unicode 與 ANSI 名稱 |
DsRestorePrepareW (Unicode) 和 DsRestorePrepareA (ANSI) |