IFsiDirectoryItem：：AddFile 方法 (imapi2fs.h)

将文件添加到文件系统映像。

语法

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

[in] path

包含要包含新文件的目录的相对路径的字符串。

从根目录项调用此方法时指定完整路径。

[in] fileData

文件的 IStream 接口 (数据流) 写入媒体。

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

返回代码	说明
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