共用方式為

IFsiDirectoryItem2：：AddTreeWithNamedStreams 方法 (imapi2fs.h)

  • 發行項

將目錄樹狀目錄的內容以及與所有檔案相關聯的具名資料流程新增至檔案系統映射。

語法

HRESULT AddTreeWithNamedStreams(
  [in] BSTR         sourceDirectory,
  [in] VARIANT_BOOL includeBaseDirectory
);

參數

[in] sourceDirectory

字串，其中包含要建立之目錄樹狀目錄的相對路徑。 路徑應該只包含根據檔案系統命名慣例的有效字元。 此參數不可為 Null。

注意 您必須從根目錄專案呼叫這個方法時指定完整路徑。
 

[in] includeBaseDirectory

設定為 VARIANT_TRUE ，以將目錄包含在 sourceDirectory 中，做為檔案系統映射中的子目錄。 否則， VARIANT_FALSE。

傳回值

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

傳回碼/值 描述
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
值：0x00AAB15FL
 目前檔案系統修訂不支援此功能，因此，將會在沒有此功能的情況下建立此功能。
IMAPI_E_INVALID_PARAM
值：0xC0AAB101
 為參數 '%1！ls！' 指定的值 無效。
IMAPI_E_NOT_IN_FILE_SYSTEM
值：0xC0AAB10B
 ls！' 不是檔案系統的一部分。 它必須新增才能完成這項作業。
IMAPI_E_DATA_STREAM_CREATE_FAILURE
值：值：0xC0AAB12AL
 建立 '%1！ls！'的資料流程時發生錯誤。
IMAPI_E_DATA_STREAM_READ_FAILURE
值：0xC0AAB129L
 無法從為檔案 '%1！ls！'提供的資料流程讀取資料。
IMAPI_E_READONLY
值：0xC0AAB102
 參考的 IFileSystemImage 物件處於唯讀模式。
IMAPI_E_DUP_NAME
值：0xC0AAB112L
 '%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
 無法配置必要的記憶體。

備註

新子目錄的父目錄必須已存在於檔案系統映射內。

指定 sourceDirectory 內的子目錄結構會在檔案系統映射中隱含鏡像。 如果發生檔案或目錄衝突，則指定來原始目錄的內容會優先。

檔案系統映射會以來原始目錄中的適當目錄和檔案覆寫。 如果在處理期間發生例外狀況，檔案系統映射會還原成其先前的狀態。

如果針對未在結果映射中建立的檔案系統清單中，或 UDF 修訂低於 2.00 的檔案系統物件叫用這個方法，這個方法會傳回成功程式碼 IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED。 這表示已新增具名資料流程，但除非檔案系統物件中已啟用 UDF 修訂 2.00 或更高版本，否則不會出現在產生的檔案系統映射中。

使用替代資料流程 (ADS) 請務必注意檔案系統映射有 1000 個數據流的限制。 超過此數位會導致資料遺失。

Windows Server 2003 搭配 Service Pack 1 (SP1) 、Windows XP 搭配 Service Pack 2 (SP2) ，以及 Windows Vista 透過 Windows Feature Pack for Storage 支援此方法。 此更新套件所提供的所有功能在 Windows 7 和 Windows Server 2008 R2 中原生支援。

需求

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

另請參閱

IFsiDirectoryItem2