Функция 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 не поддерживаются.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|
| Имя в кодировке Юникод и ANSI |
DsBackupGetBackupLogsW (Юникод) и DsBackupGetBackupLogsA (ANSI) |