IFsiDirectoryItem：：AddFile 方法 (imapi2fs.h)

將檔案新增至文件系統映像。

語法

HRESULT AddFile(
  [in] BSTR    path,
  [in] IStream *fileData
);

[in] path

字串，其中包含要包含新檔案之目錄的相對路徑。

從根目錄項目呼叫此方法時，請指定完整路徑。

[in] fileData

檔案的 IStream 介面 (數據流) 寫入媒體。

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

傳回碼	Description
IMAPI_E_INVALID_PATH	路徑 '%1！s！' 格式不正確，或包含無效字元。值：0xC0AAB110
E_POINTER	指標無效。值：0x80004003
IMAPI_E_INVALID_PARAM	為參數 %1！ls！指定的值無效。值：0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM	ls！' 不是文件系統的一部分。它必須新增才能完成這項作業。值：0xC0AAB10B
IMAPI_E_READONLY	FileSystemImage 對象處於唯讀模式。值：0xC0AAB102

將包含新檔案的目錄必須已存在於檔案系統映像內。

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