Функция DsRestorePrepare
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с Windows Vista, используйте службу теневого копирования томов (VSS ).]
Функция DsRestorePrepare подключается к указанному серверу каталогов и подготавливает его к операции восстановления.
Синтаксис
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
Параметры
-
szServerName [in]
-
Указатель на строку с пустым завершением, содержащую имя восстанавливаемого сервера. Предыдущие обратные косые черти являются необязательными. Сервер должен быть тем же компьютером, с которым вызывается эта функция. Имя сервера не может содержать символы подчеркивания (_). Пример имени сервера — \\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 требует, чтобы вызывающий объект был членом группы администраторов на сервере.
DsRestorePrepare можно использовать с предоставленным маркером или без него. Если маркер предоставлен, он проверяется на срок действия, и все операции разрешены в возвращаемом контексте. Если маркер не указан, возвращаемый контекст ограничивается и может использоваться только для функции DsRestoreGetDatabaseLocations . Его нельзя использовать для функции DsRestoreRegister .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|
| Имя в кодировке Юникод и ANSI |
DsRestorePrepareW (Юникод) и DsRestorePrepareA (ANSI) |