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

Article
08/24/2023

Écrit un flux de données dans l’enregistreur actuel.

Syntaxe

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

Paramètres

[in] data

Interface IStream du flux de données à écrire dans l’enregistreur.

[in] startingBlockAddress

Démarrage de l’adresse de bloc logique (LBA) de l’opération d’écriture. Les valeurs négatives sont prises en charge.

[in] numberOfBlocks

Nombre de blocs du flux de données à écrire.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour	Description
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides. Valeur : 0x80070057
E_IMAPI_REQUEST_CANCELLED	La demande a été annulée. Valeur : 0xC0AA0002

Notes

Avant d’appeler cette méthode, vous devez appeler la méthode IWriteEngine2::p ut_Recorder pour spécifier le périphérique d’enregistrement et la méthode IWriteEngine2::p ut_BytesPerSector pour spécifier le nombre d’octets à utiliser pour chaque secteur pendant l’écriture.

Vous devez également envisager d’appeler les méthodes suivantes si leurs valeurs par défaut ne conviennent pas à votre application :

Cette méthode est synchrone. Pour déterminer la progression de l’opération d’écriture, vous devez implémenter l’interface DWriteEngine2Events . Pour obtenir des exemples qui montrent comment implémenter un gestionnaire d’événements dans un script, consultez Surveillance de la progression avec les événements.

Configuration requise


Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi2.h