IWriteEngine2::WriteSection-Methode (imapi2.h)

Artikel
08/24/2023

Schreibt einen Datenstrom in den aktuellen Rekorder.

Syntax

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

Parameter

[in] data

Eine IStream-Schnittstelle des Datenstroms, der in den Rekorder geschrieben werden soll.

[in] startingBlockAddress

Starten der logischen Blockadresse (LBA) des Schreibvorgangs. Negative Werte werden unterstützt.

[in] numberOfBlocks

Anzahl der zu schreibenden Blöcke aus dem Datenstrom.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
E_OUTOFMEMORY	Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_INVALIDARG	Mindestens ein Argument ist ungültig. Wert: 0x80070057
E_IMAPI_REQUEST_CANCELLED	Die Anforderung wurde abgebrochen. Wert: 0xC0AA0002

Hinweise

Bevor Sie diese Methode aufrufen, müssen Sie die IWriteEngine2::p ut_Recorder-Methode aufrufen, um das Aufzeichnungsgerät und die IWriteEngine2::p ut_BytesPerSector-Methode anzugeben, um die Anzahl der Bytes anzugeben, die während des Schreibens für jeden Sektor verwendet werden sollen.

Sie sollten auch die folgenden Methoden aufrufen, wenn ihre Standardwerte nicht für Ihre Anwendung geeignet sind:

Diese Methode ist synchron. Um den Fortschritt des Schreibvorgangs zu ermitteln, müssen Sie die DWriteEngine2Events-Schnittstelle implementieren. Beispiele zum Implementieren eines Ereignishandlers in einem Skript finden Sie unter Überwachen des Fortschritts mit Ereignissen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi2.h