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


Функция DsBackupOpenFile

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

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