Функция DsBackupGetDatabaseNames

Статья
06/13/2023

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

Функция DsBackupGetDatabaseNames получает список файлов базы данных для резервного копирования для заданного контекста резервного копирования.

Синтаксис

HRESULT DsBackupGetDatabaseNames(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszAttachmentInfo,
  _Out_ LPDWORD pcbSize
);

Параметры

hbc [in]

Содержит дескриптор контекста резервного копирования, полученный с помощью функции DsBackupPrepare .

pszAttachmentInfo [out]

Указатель на строковый указатель, который получает список имен файлов базы данных в виде UNC-путей. Это значение должно быть инициализировано значением NULL перед вызовом DsBackupGetDatabaseNames.

Этот список получает список строк с двойным завершением NULL.

Этот буфер выделяется функцией DsBackupGetDatabaseNames и должен быть освобожден, если он больше не требуется путем вызова функции DsBackupFree .

Первый символ каждого имени файла содержит одну из констант BFT , которая определяет тип имени. Функция DsRestoreGetDatabaseLocations предоставляет только следующие типы имен.

BFT_NTDS_DATABASE

Файл является файлом базы данных NTDS. Этот файл следует скопировать в файл, определенный как BFT_NTDS_DATABASE при восстановлении данных.

BFT_LOG

Файл является файлом журнала. Все файлы журналов копируются в каталог, указанный как BFT_LOG_DIR при восстановлении данных.

BFT_PATCH_FILE

Файл является файлом исправлений. Все файлы исправлений копируются в каталог, определенный как BFT_CHECKPOINT_DIR при восстановлении данных.

pcbSize [out]

Указатель на значение DWORD , которое получает размер буфера pszAttachmentInfo в байтах.

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

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

ERROR_ACCESS_DENIED: Вызывающий объект не имеет соответствующих прав доступа для вызова этой функции. С помощью функции DsSetAuthIdentity можно задать учетные данные, используемые для функций резервного копирования и восстановления.
ERROR_INVALID_PARAMETER: Недопустимы hbc, pszAttachmentInfo или pcbSize .
ERROR_NOT_ENOUGH_MEMORY: Произошел сбой выделения памяти.

Функция DsBackupGetDatabaseNames предоставляет список файлов базы данных, необходимых для резервного копирования. Полная резервная копия состоит из файлов базы данных и файлов журналов, предоставляемых функцией DsBackupGetBackupLogs . Добавочные резервные копии серверов Active Directory не поддерживаются.

Требования

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

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

DsBackupPrepare
DsBackupFree
DsBackupGetBackupLogs
Константы BFT
Резервное копирование сервера Active Directory
Функции резервного копирования каталогов

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