Método IWriteEngine2::WriteSection (imapi2.h)

Artículo
08/24/2023

Escribe un flujo de datos en la grabadora actual.

Sintaxis

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

Parámetros

[in] data

Interfaz IStream del flujo de datos que se va a escribir en la grabadora.

[in] startingBlockAddress

Inicio de la dirección de bloque lógico (LBA) de la operación de escritura. Se admiten valores negativos.

[in] numberOfBlocks

Número de bloques del flujo de datos que se va a escribir.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto	Descripción
E_POINTER	El puntero no es válido. Valor: 0x80004003
E_OUTOFMEMORY	No se pudo asignar la memoria necesaria. Valor: 0x8007000E
E_INVALIDARG	Uno o varios argumentos no son válidos. Valor: 0x80070057
E_IMAPI_REQUEST_CANCELLED	Se ha cancelado la solicitud. Valor: 0xC0AA0002

Comentarios

Antes de llamar a este método, debe llamar al método IWriteEngine2::p ut_Recorder para especificar el dispositivo de grabación y el método IWriteEngine2::p ut_BytesPerSector para especificar el número de bytes que se van a usar para cada sector durante la escritura.

También debe considerar la posibilidad de llamar a los métodos siguientes si sus valores predeterminados no son adecuados para la aplicación:

Este método es sincrónico. Para determinar el progreso de la operación de escritura, debe implementar la interfaz DWriteEngine2Events . Para obtener ejemplos que muestran cómo implementar un controlador de eventos en un script, consulte Supervisión del progreso con eventos.

Requisitos


Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	imapi2.h