IFileSystemImage：：get_StageFiles 方法 (imapi2fs.h)

指出將檔案新增至文件系統映像之前是否應該暫存。

語法

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

[out] pVal

VARIANT_TRUE 如果需要將檔案新增至文件系統映像，才能在一或多個階段檔案中暫存，再進行擷取。否則，如果允許 IMAPI 將映像建立程式優化，則會傳回 VARIANT_FALSE ，方法是不要暫存要新增至文件系統映像的檔案。

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

傳回碼	Description
E_POINTER	指標無效。值：0x80004003

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

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

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

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

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