IFsiDirectoryItem：：Add 方法 (imapi2fs.h)

将 IFsiItem 对象描述的文件或目录添加到文件系统映像。

语法

HRESULT Add(
  [in] IFsiItem *item
);

[in] item

S_OK成功后返回，但其他成功代码可能由于实现而返回。以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：

返回代码	说明
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！” 失败：无法为 %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