Функция DsBackupRead

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с 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

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