IWriteEngine2::WriteSection 方法 (imapi2.h)

将数据流写入当前记录器。

语法

HRESULT WriteSection(
  [in] IStream *data,
  [in] LONG    startingBlockAddress,
  [in] LONG    numberOfBlocks
);

parameters

[in] data

要写入记录器的数据流的 IStream 接口。

[in] startingBlockAddress

(LBA) 写入操作启动逻辑块地址。 支持负值。

[in] numberOfBlocks

要写入的数据流中的块数。

返回值

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

返回代码 说明
E_POINTER
指针无效。

值:0x80004003

E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

E_INVALIDARG
一个或多个参数无效。

值:0x80070057

E_IMAPI_REQUEST_CANCELLED
请求已被取消。

值:0xC0AA0002

注解

在调用此方法之前,必须调用 IWriteEngine2::p ut_Recorder 方法来指定记录设备,并调用 IWriteEngine2::p ut_BytesPerSector 方法来指定写入过程中要用于每个扇区的字节数。

如果以下方法的默认值不适合应用程序,则还应考虑调用这些方法:

此方法是同步方法。 若要确定写入操作的进度,必须实现 DWriteEngine2Events 接口。 有关演示如何在脚本中实现事件处理程序的示例,请参阅 使用事件监视进度

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::CancelWrite

IWriteEngine2::get_WriteInProgress

IWriteEngine2EventArgs::get_SectorCount

IWriteEngine2EventArgs::get_StartLba