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


Метод IJolietDiscMaster::AddData (imapi.h)

Добавляет содержимое корневого хранилища в файл промежуточного образа. Это хранилище будет перечислено для размещения всех вложенных журналов и потоков в корневой файловой системе файла образа этапа. Вложенные журналы становятся папками, а потоки — файлами. Несколько вызовов этого метода можно повторить для медленной подготовки файла образа, не тратя неоправданное количество места на жестком диске для создания файла хранилища.

Синтаксис

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

Параметры

[in] pStorage

Путь к хранилищу, подэлементы которого необходимо добавить в корень файла промежуточного образа.

[in] lFileOverwrite

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

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

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

Комментарии

При повторе операции AddData папки с повторяющимися файлами вызывают проверку lFileOverwrite. Если флаг не является нулевым, файл перезаписывается. Предыдущие файлы с конфликтующими именами по-прежнему записываются на диск из файла образа. Если значение lFileOverwrite равно нулю и файл с тем же именем существует, AddData завершается сбоем с IMAPI_E_FILEEXISTS.

Хотя метод AddData можно вызывать несколько раз после вызова IDiscMaster::SetActiveDiscRecorder, метод SetActiveDiscRecorder должен вызываться при запуске нового образа и непосредственно перед первым вызовом AddData , независимо от того, используется ли горелка при создании предыдущего образа.

Если вызов этого метода перерасходит количество доступных блоков данных, метод возвращает IMAPI_E_DISCFULL и пропускает все добавляемые данные. Это гарантирует, что окончательная файловая система Joliet не повреждена.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi.h
Библиотека Uuid.lib
DLL Actxprxy.dll

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

IJolietDiscMaster