通过

IFsiNamedStreams：：get_Item 方法 (imapi2fs.h)

  • 项目

检索与文件系统映像中的文件关联的单个命名流。

语法

HRESULT get_Item(
  [in]            LONG          index,
  [out, optional] IFsiFileItem2 **item
);

parameters

[in] index

此值指示命名流在集合中的位置。 索引号从零开始，即第一个项位于集合的位置 0。

[out, optional] item

指向 指向 IFsiFileItem2 对象的指针的指针，该对象表示 索引指定位置处的命名流。 如果指定的索引不在集合边界内，则此参数设置为 NULL 。

返回值

S_OK成功后返回，但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：

返回代码/值 说明
E_POINTER
值：0x80004003
 指针无效。
IMAPI_E_INVALID_PARAM
值：0xC0AAB101
 为参数 '%1！ls！' 指定的值 之间的时间间隔无效。

注解

如果索引号为负数或范围外，此方法将返回 IMAPI_E_INVALID_PARAM。

若要提取与文件关联的所有命名流的 IEnumVARIANT 枚举器，请使用 IFsiNamedStreams：：get__NewEnum 方法。

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

另请参阅

IFsiNamedStreams