共用方式為

IFsiFileItem2：：AddStream 方法 (imapi2fs.h)

  • 發行項

將具名數據流與文件系統映像中的特定檔案產生關聯。

語法

HRESULT AddStream(
  [in] BSTR    name,
  [in] IStream *streamData
);

參數

[in] name

字串代表具名數據流的名稱。 這不應該包含路徑，而且應該只根據文件系統命名慣例包含有效的字元。

[in] streamData

用來寫入結果文件系統映像之具名數據流的 IStream 介面。

傳回值

S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

傳回碼/值 Description
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，這個方法會傳回成功碼 IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED。 此成功程式代碼表示已新增具名數據流，但除非文件系統物件中已啟用 UDF 修訂 2.00 或更高版本，否則不會出現在結果文件系統映射中。

目前 ，IMAPI_E_READONLY 在匯入的文件系統映像上呼叫此方法時傳回，而不論映像的只讀狀態為何。

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

另請參閱

IFsiFileItem2