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 函数要求调用方是服务器上管理员istrators 组的成员。

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