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

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

  • Статья

Удаляет указанный элемент из образа файловой системы.

Синтаксис

HRESULT Remove(
  [in] BSTR path
);

Параметры

[in] path

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

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

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

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

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

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

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

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

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

Значение: 0xC0AAB102
IMAPI_E_DIR_NOT_EMPTY
 Каталог %1!s! не пуст.

Значение: 0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR
 Произошла внутренняя ошибка: %1!ls!.

Значение: 0xC0AAB100

Комментарии

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

Требования

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

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

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::RemoveTree