Metodo IWriteEngine2::WriteSection (imapi2.h)

Articolo
08/24/2023

Scrive un flusso di dati nel registratore corrente.

Sintassi

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

Parametri

[in] data

Interfaccia IStream del flusso di dati da scrivere nel registratore.

[in] startingBlockAddress

Avvio dell'indirizzo di blocco logico (LBA) dell'operazione di scrittura. I valori negativi sono supportati.

[in] numberOfBlocks

Numero di blocchi dal flusso di dati da scrivere.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E
E_INVALIDARG	Uno o più argomenti non sono validi. Valore: 0x80070057
E_IMAPI_REQUEST_CANCELLED	La richiesta è stata annullata. Valore: 0xC0AA0002

Commenti

Prima di chiamare questo metodo, è necessario chiamare il metodo IWriteEngine2::p ut_Recorder per specificare il dispositivo di registrazione e il metodo IWriteEngine2::p ut_BytesPerSector per specificare il numero di byte da usare per ogni settore durante la scrittura.

È anche consigliabile chiamare i metodi seguenti se i valori predefiniti non sono appropriati per l'applicazione:

Questo metodo è asincrono. Per determinare lo stato di avanzamento dell'operazione di scrittura, è necessario implementare l'interfaccia DWriteEngine2Events . Per esempi che illustrano come implementare un gestore eventi in uno script, vedere Monitoraggio dello stato di avanzamento con eventi.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2.h