Функция DsBackupOpenFile

Статья
06/12/2023

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

Функция DsBackupOpenFile открывает указанный файл и выполняет операции клиента и сервера, необходимые для подготовки файла к резервной копии.

Синтаксис

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

Параметры

hbc [in]: Содержит дескриптор контекста резервного копирования, полученный с помощью функции DsBackupPrepare .
szAttachmentName [in]: Указатель на строку, завершающуюся значением NULL, которая указывает имя файла резервной копии для открытия.
cbReadHintSize [in]: Содержит возможный размер (в байтах) буфера, передаваемого в качестве аргумента pvBuffer в функции DsBackupRead . Функции резервного копирования используют это значение в качестве указания для оптимизации сетевого трафика. Это значение должно быть кратно 8192 и должно быть больше или равно 24576.
pliFileSize [out]: Указатель на LARGE_INTEGER значение, которое получает размер открытого файла резервной копии (в байтах).

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Ntdsbcli.h
Библиотека	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Имя в кодировке Юникод и ANSI	DsBackupOpenFileW (Юникод) и DsBackupOpenFileA (ANSI)

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

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

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