Метод 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