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

Метод IFsiDirectoryItem::AddFile (imapi2fs.h)

  • Статья

Добавляет файл в образ файловой системы.

Синтаксис

HRESULT AddFile(
  [in] BSTR    path,
  [in] IStream *fileData
);

Параметры

[in] path

Строка, содержащая относительный путь к каталогу, в котором будет содержаться новый файл.

Укажите полный путь при вызове этого метода из корневого элемента каталога.

[in] fileData

Интерфейс IStream файла (потока данных) для записи на носитель.

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

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

Код возврата Описание
IMAPI_E_INVALID_PATH
 Путь "%1!s!" имеет неправильный формат или содержит недопустимые символы.

Значение: 0xC0AAB110
E_POINTER
 Недопустимый указатель.

Значение: 0x80004003
IMAPI_E_INVALID_PARAM
 Недопустимое значение параметра %1!ls! .

Значение: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM
 ls! не является частью файловой системы. Его необходимо добавить для завершения этой операции.

Значение: 0xC0AAB10B
IMAPI_E_READONLY
 Объект FileSystemImage находится в режиме только для чтения.

Значение: 0xC0AAB102

Комментарии

Каталог, который будет содержать новый файл, должен уже существовать в образе файловой системы.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2fs.h

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

IFsiDirectoryItem

IFsiDirectoryItem::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::Remove