Функция DsBackupGetBackupLogs

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

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

Синтаксис

HRESULT DsBackupGetBackupLogs(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszBackupLogFiles,
  _Out_ LPDWORD pcbSize
);

Параметры

hbc [in]

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

pszBackupLogFiles [out]

Указатель на строковый указатель, который получает список имен файлов журнала в виде UNC-путей. Инициализируйте это значение null перед вызовом DsBackupGetBackupLogs.

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

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

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

pcbSize [out]

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

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

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

ERROR_ACCESS_DENIED

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

ERROR_INVALID_PARAMETER

недопустимые hbc, pszBackupLogFiles или pcbSize .

ERROR_NOT_ENOUGH_MEMORY

Произошел сбой выделения памяти.

Комментарии

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

Требования

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

DsBackupFree

DsBackupGetDatabaseNames

Константы BFT

Резервное копирование сервера Active Directory

Функции резервного копирования каталогов