Функция DsRestoreRegister

Статья
06/13/2023

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с Windows Vista, используйте службу теневого копирования томов (VSS ).]

Функция DsRestoreRegister регистрирует операцию восстановления. Эта функция блокирует все последующие операции восстановления и предотвращает запуск целевого объекта восстановления до вызова функции DsRestoreRegisterComplete .

Синтаксис

HRESULT DsRestoreRegister(
  _In_ HBC        hbc,
  _In_ LPCTSTR    szCheckPointFilePath,
  _In_ LPCTSTR    szLogPath,
  _In_ EDB_RSTMAP rgrstmap[],
  _In_ LONG       crstmap,
  _In_ LPCTSTR    szBackupLogPath,
  _In_ ULONG      genLow,
  _In_ ULONG      genHigh
);

Параметры

hbc [in]: Содержит дескриптор контекста восстановления, полученный с помощью функции DsRestorePrepare .
szCheckPointFilePath [in]: Указатель на строку, завершающуюся значением NULL, которая содержит путь к файлу контрольной точки. Этот путь предоставляется функцией DsRestoreGetDatabaseLocations и имеет значение BFTBFT_CHECKPOINT_DIR. Обычно это то же, что и путь к системной базе данных. Этот путь необходим для правильной функции восстановления резервных копий. Этот параметр не может иметь значение NULL. Передача null в этом параметре приведет к ошибке во время восстановления.
szLogPath [in]: Указатель на строку, завершающуюся значением NULL, которая содержит путь, по которому будут восстановлены файлы журнала. Этот путь предоставляется функцией DsRestoreGetDatabaseLocations и имеет значение BFTBFT_LOG_DIR. Если путь указывает на пустой каталог, в нем создаются новые файлы журнала. Этот параметр не может иметь значение NULL.
rgrstmap [in]: Массив EDB_RSTMAP структур, содержащий старый и новый пути для каждой базы данных. Для каждой базы данных существует одна структура. Для каталога имеется структура системной базы данных и другая структура для базы данных каталогов. Порядок элементов в массиве не имеет значения. Параметр crstmap содержит количество элементов в массиве.
crstmap [in]: Содержит количество элементов в массиве rgrstmap .
szBackupLogPath [in]: Указатель на строку, завершающуюся значением NULL, которая содержит путь, по которому в настоящее время находятся резервные копии файлов журнала. Этот параметр не может иметь значение NULL.
genLow [in]: Содержит наименьший номер журнала для восстановления в этом сеансе восстановления. Это шестнадцатеричное число в диапазоне от 0x00000 до 0xFFFFF.
genHigh [in]: Содержит наибольший номер журнала для восстановления в этом сеансе восстановления. Это шестнадцатеричное число в диапазоне от 0x00000 до 0xFFFFF.

Возвращаемое значение

Возвращает S_OK , если функция выполнена успешно, или код ошибки Win32 или RPC в противном случае. В следующем списке перечислены возможные коды ошибок.

ERROR_ACCESS_DENIED: Вызывающий объект не имеет соответствующих прав доступа для вызова этой функции. С помощью функции DsSetAuthIdentity можно задать учетные данные для функций резервного копирования и восстановления.
ERROR_INVALID_PARAMETER: Один или несколько параметров недопустимы.
hrMissingExpiryToken: Маркер истечения срока действия, предоставленный DsRestorePrepare , недопустим. Это значение определено в ntdsbmsg.h.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Ntdsbcli.h
Библиотека	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Имя в кодировке Юникод и ANSI	DsRestoreRegisterW (Юникод) и DsRestoreRegisterA (ANSI)

См. также раздел

DsRestoreRegisterComplete
DsRestorePrepare
DsRestoreGetDatabaseLocations
DsRestoreEnd
EDB_RSTMAP
Восстановление Active Directory
Функции резервного копирования каталогов

Поделиться через