通过

IFsiFileItem2：：RemoveStream 方法 (imapi2fs.h)

  • 项目

删除与文件的命名流关联。

语法

HRESULT RemoveStream(
  [in] BSTR name
);

parameters

[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
 未能分配所需的内存。

注解

只能对文件系统映像中存在的文件项调用此方法。

用户必须启用 UDF 并将 UDF 修订版设置为 2.00 或更高版本才能支持命名流。

Windows Server 2003 支持此方法，Service Pack 1 (SP1) 、Windows XP with Service Pack 2 (SP2) ，以及 Windows Vista 通过适用于存储的 Windows 功能包。 Windows 7 和 Windows Server 2008 R2 原生支持此更新包提供的所有功能。

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2fs.h

另请参阅

IFsiFileItem2

IFsiFileItem2：：AddStream