共用方式為

IFsiNamedStreams：：get_Item 方法 (imapi2fs.h)

  • 發行項

擷取與檔案系統映射中檔案相關聯的單一具名資料流程。

語法

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

參數

[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 service Pack 2 (SP2) ，以及透過 Windows Feature Pack for Storage 支援此方法。 Windows 7 和 Windows Server 2008 R2 原生支援此更新套件所提供的所有功能。

需求

   
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imapi2fs.h

另請參閱

IFsiNamedStreams