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 |
| 标头 |
|
| 库 |
|
| DLL |
|
| Unicode 和 ANSI 名称 |
DsRestorePrepareW （Unicode） 和 DsRestorePrepareA （ANSI） |