IFsiDirectoryItem：：Add 方法 (imapi2fs.h)

將 IFsiItem 物件所描述的檔案或目錄新增至檔案系統映像。

語法

HRESULT Add(
  [in] IFsiItem *item
);

[in] item

要新增至文件系統映像之 IFsiFileItem 或 IFsiDirectoryItem 的 IFsiItem 介面。

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

傳回碼	Description
E_POINTER	指標無效。值：0x80004003
IMAPI_E_INVALID_PATH	路徑 '%1！s！' 格式不正確或包含無效字元。值：0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE	無法從為檔案 '%1！ls！' 提供的數據流讀取數據。值：0xC0AAB129
IMAPI_E_DUP_NAME	ls！' 名稱已經存在。值：0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	嘗試新增 '%1！ls！' failed：無法建立 %2！ls！的檔案系統特定唯一名稱檔案系統)。值：0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT	新增 '%1！ls！' 會導致結果映像的大小大於目前設定的限制。值：0xC0AAB120
IMAPI_E_ISO9660_LEVELS	ISO9660限制為8個層級的目錄。值：0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	此檔案系統映像的 %1！ls！目錄太多檔案系統)。值：0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	目錄 %1！s！' 在 FileSystemImage 階層中找不到。值：0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM	這個檔案或目錄不是文件系統的一部分。必須新增它才能完成此作業。值：0xC0AAB10B
IMAPI_E_READONLY	FileSystemImage 對象處於唯讀模式。值：0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT	新增此檔案或目錄會導致結果映像的大小大於目前設定的限制。值：0xC0AAB120
E_OUTOFMEMORY	無法配置所需的記憶體。值：0x8007000E

注意 IUnknown：：QueryInterface 方法傳回的值也可以在這裡傳回。

將專案新增至文件系統映射之後， IFsiFileItem：：get_Data 屬性會變成唯讀。

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