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

Метод IFsiFileItem2::RemoveStream (imapi2fs.h)

  • Статья

Удаляет именованную связь потока с файлом.

Синтаксис

HRESULT RemoveStream(
  [in] BSTR name
);

Параметры

[in] name

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

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

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

Возвращаемый код/значение Описание
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
Значение: 0x00AAB15FL
 Компонент не поддерживается для текущей редакции файловой системы, и в результате будет создан без этой функции.
E_POINTER
Значение: 0x80004003
 Недопустимый указатель.
IMAPI_E_INVALID_PARAM
Значение: 0xC0AAB101
 Значение, указанное для параметра "%1!ls!". является недопустимым.
IMAPI_E_NOT_IN_FILE_SYSTEM
Значение: 0xC0AAB10B
 ls! не является частью файловой системы. Его необходимо добавить для завершения этой операции.
IMAPI_E_READONLY
Значение: 0xC0AAB102
 Указанный объект IFileSystemImage находится в режиме только для чтения.
IMAPI_E_FSI_INTERNAL_ERROR
Значение: 0xC0AAB100L
 Произошла внутренняя ошибка файловой системы.
IMAPI_E_DUP_NAME
Значение: 0xC0AAB112L
 "%1!ls!" имя уже существует.
IMAPI_E_DATA_STREAM_READ_FAILURE
Значение: 0xC0AAB129L
 Не удается прочитать данные из потока, предоставленного для файла "%1!ls!".
IMAPI_E_IMAGE_SIZE_LIMIT
Значение: 0xC0AAB120L
 Добавление "%1!ls!" , приведет к тому, что размер результирующих изображений превышает текущее настроенное ограничение.
IMAPI_E_DATA_STREAM_INCONSISTENCY
Значение: 0xC0AAB128L
 Поток данных, предоставленный для файла "%1!ls!" , является несогласованным; ожидается %2! I64d! байт, найдено %3! I64d!
E_OUTOFMEMORY
Значение: 0x8007000EL
 Не удалось выделить необходимую память.

Комментарии

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

Пользователь должен включить определяемую пользователем функцию и задать для редакции определяемой пользователем функции значение 2.00 или более поздней версии для поддержки именованных потоков.

Этот метод поддерживается в Windows Server 2003 с пакетом обновления 1 (SP1), Windows XP с пакетом обновления 2 (SP2) и Windows Vista с помощью пакета дополнительных компонентов Windows для хранилища. Все функции, предоставляемые этим пакетом обновления, изначально поддерживаются в Windows 7 и Windows Server 2008 R2.

Требования

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

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

IFsiFileItem2

IFsiFileItem2::AddStream