IJolietDiscMaster：：AddData 方法 (imapi.h)

将根存储的内容添加到暂存映像文件。 将枚举此存储以将所有子存储和流放置在阶段映像文件的根文件系统中。 子存储成为文件夹，流成为文件。 可以重复对此方法的多次调用，以缓慢暂存图像文件，而不会浪费构建存储文件的不当硬盘驱动器空间。

语法

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

参数

[in] pStorage

要将其子项添加到暂存映像文件的根目录的存储的路径。

[in] lFileOverwrite

如果此参数为非零值，请覆盖同名的现有文件。 否则，添加的最后一个文件将显示在 目录中。

返回值

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

注解

重复 AddData 操作时，包含重复文件的文件夹会导致 lFileOverwrite 测试。 如果标志为非零值，则会覆盖该文件。 名称冲突的早期文件仍会从映像文件写入光盘。 如果 lFileOverwrite 为零并且存在同名的文件， 则 AddData 将失败并IMAPI_E_FILEEXISTS。

虽然在调用 IDiscMaster：：SetActiveDiscRecorder 后可以多次调用 AddData，但每当启动新映像时，以及第一次 AddData 调用之前，都必须调用 SetActiveDiscRecorder，而不管燃烧器是否与之前创建映像中使用的相同。

如果对此方法的调用会超出可用数据块的数量，该方法将返回IMAPI_E_DISCFULL并忽略要添加的所有数据。 这可确保最终的 Joliet 文件系统未损坏。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi.h
Library	Uuid.lib
DLL	Actxprxy.dll

另请参阅

IJolietDiscMaster