Функция 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 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|