DsSetCurrentBackupLog 函式

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

DsSetCurrentBackupLog函式會在還原成功之後設定目前的備份記錄號碼。因為Active Directory 網域服務只支援迴圈記錄，所以通常不會使用此函式。

語法

HRESULT DsSetCurrentBackupLog(
  _In_ LPCWSTR szServerName,
  _In_ DWORD   dwCurrentLog
);

szServerName [in]: Null 終止字串的指標，其中包含要設定備份記錄號碼的伺服器名稱。上述反斜線是選擇性的。伺服器必須是呼叫此函式的相同電腦。伺服器名稱不能包含任何底線 (_) 字元。伺服器名稱的範例是「\\server1」。
dwCurrentLog [in]: 包含要設定的備份記錄號碼。

如果函式成功或 Win32 或 RPC 錯誤碼，則傳回 S_OK 。下列清單列出可能的錯誤碼。

通常不需要呼叫 DsSetCurrentBackupLog 函式。備份函式會自動判斷並設定備份的最後一個記錄號碼。使用 DsSetCurrentBackupLog 防止另一個增量備份成功，直到執行完整備份為止。

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