Функция DsBackupRead

Статья
06/13/2023

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

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

Синтаксис

HRESULT DsBackupRead(
  _In_  HBC    hbc,
  _In_  PVOID  pvBuffer,
  _In_  DWORD  cbBuffer,
  _Out_ PDWORD pcbRead
);

Параметры

hbc [in]: Содержит дескриптор контекста резервного копирования, полученный с помощью функции DsBackupPrepare .
pvBuffer [in]: Указатель на буфер, который получает данные. Размер этого буфера должен быть не менее байтов cbBuffer .
cbBuffer [in]: Содержит размер буфера в байтах в pvBuffer. Это значение должно быть кратно 8192 и должно быть больше или равно 24576.
pcbRead [out]: Указатель на значение DWORD , которое получает фактическое число прочитанных байтов. Это может быть меньше запрошенного числа байтов, так как некоторые транспортируют передаваемый буфер, а не заполняют весь буфер данными.

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

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

ERROR_INVALID_PARAMETER: Один или несколько параметров являются недопустимыми.
ERROR_HANDLE_EOF: Достигнут конец файла резервной копии.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Ntdsbcli.h
Библиотека	Ntdsbcli.lib
DLL	Ntdsbcli.dll

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

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

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