IFileSystemImage：:p ut_StageFiles 方法 (imapi2fs.h)

判斷要新增至文件系統映像的檔案是否應暫存，再進行擷取。

語法

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

參數

[in] newVal

設定為 VARIANT_TRUE，以強制將檔案新增至文件系統映像，以在一或多個階段檔案中暫存，然後再進行擷取。 否則，如果不需要預備，而且需要較高的效能，請將 設定為 VARIANT_FALSE。

傳回值

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

傳回碼	Description
E_NOTIMPL	未實作。 值：0x80004001

備註

「預備」是在硬碟上建立映像的程式，其中包含在開始進行擷取作業之前，所有要被刻錄的檔案。

將此屬性設定為 VARIANT_TRUE 只會影響屬性設定之後新增的檔案：這些檔案一律會暫存。 在指定的屬性值VARIANT_TRUE之前暫 存的檔案將不會暫存。

藉由指定 VARIANT_FALSE，文件系統映像建立程式會以兩種方式優化：

• 產生映像所需的時間較少
• IMAPI 在本機磁碟上耗用較少的空間

不過，若要避免在發生損毀期間發生緩衝區不足問題，非分段檔案上的讀取作業需要特定的最小輸送量。 如果檔案輔助功能或輸送量不符合使用器的需求，IMAPI 會強制執行檔案暫存，而不論指定的屬性值為何。 例如，會針對來自抽取式儲存裝置的來源檔案強制執行檔案暫存，例如USB快閃磁碟。

規格需求

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

另請參閱

IFileSystemImage

IFileSystemImage：：get_StageFiles