Функция DsBackupGetDatabaseNames
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с 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 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|
| Имя в кодировке Юникод и ANSI |
DsBackupGetDatabaseNamesW (Юникод) и DsBackupGetDatabaseNamesA (ANSI) |