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

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

  • Статья

Добавляет файл или каталог, описанный объектом IFsiItem , в образ файловой системы.

Синтаксис

HRESULT Add(
  [in] IFsiItem *item
);

Параметры

[in] item

Интерфейс IFsiItemIFsiFileItem или IFsiDirectoryItem для добавления в образ файловой системы.

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

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

Код возврата Описание
E_POINTER
 Недопустимый указатель.

Значение: 0x80004003
IMAPI_E_INVALID_PATH
 Путь "%1!s!" имеет неправильный формат или содержит недопустимые символы.

Значение: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE
 Не удается прочитать данные из потока, предоставленного для файла "%1!ls!".

Значение: 0xC0AAB129
IMAPI_E_DUP_NAME
 ls! имя уже существует.

Значение: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME
 Попытка добавить "%1!ls!" сбой: не удается создать уникальное имя файловой системы для %2!ls! .

Значение: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT
 Добавление "%1!ls!" в результате результирующий образ будет иметь размер, превышающий текущее настроенное ограничение.

Значение: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS
 ISO9660 ограничен 8 уровнями каталогов.

Значение: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS
 Этот образ файловой системы содержит слишком много каталогов для %1!ls! .

Значение: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND
 Каталог "%1!s!" не найден в иерархии FileSystemImage.

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

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

Значение: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT
Добавление этого файла или каталога приведет к тому, что результирующий образ будет иметь размер, превышающий текущее настроенное ограничение.

Значение: 0xC0AAB120
E_OUTOFMEMORY
 Не удалось выделить необходимую память.

Значение: 0x8007000E
 
Примечание Здесь также могут возвращаться значения, возвращаемые методом IUnknown::QueryInterface.
 

Комментарии

Чтобы создать элемент каталога или элемент файла, вызовите метод IFileSystemImage::CreateDirectoryItem или IFileSystemImage::CreateFileItem соответственно.

После добавления элемента в образ файловой системы свойство IFsiFileItem::get_Data становится доступным только для чтения.

Требования

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

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

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove

IFsiFileItem