Méthode IJolietDiscMaster ::AddData (imapi.h)

Ajoute le contenu d’un stockage racine au fichier image intermédiaire. Ce stockage sera énuméré pour placer tous les sous-stockages et flux dans le système de fichiers racine du fichier image de phase. Les sous-stockages deviennent des dossiers et les flux deviennent des fichiers. Plusieurs appels à cette méthode peuvent être répétés pour mettre en scène lentement un fichier image sans gaspiller des quantités excessives d’espace disque dur qui créent un fichier de stockage.

Syntaxe

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

Paramètres

[in] pStorage

Chemin du stockage dont les sous-éléments doivent être ajoutés à la racine du fichier image intermédiaire.

[in] lFileOverwrite

Si ce paramètre n’est pas nul, remplacez les fichiers existants portant le même nom. Sinon, le dernier fichier ajouté apparaît dans le répertoire.

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 :

Remarques

Lorsque vous répétez une opération AddData , les dossiers contenant des fichiers en double entraînent un test de lFileOverwrite. Si l’indicateur est différent de zéro, le fichier est remplacé. Les fichiers antérieurs avec des noms en conflit sont toujours écrits sur le disque à partir du fichier image. Si lFileOverwrite a la valeur zéro et qu’un fichier portant le même nom existe, AddData échoue avec IMAPI_E_FILEEXISTS.

Si AddData peut être appelé plusieurs fois après l’appel de IDiscMaster ::SetActiveDiscRecorder, SetActiveDiscRecorder doit être appelé chaque fois qu’une nouvelle image est démarrée et immédiatement avant le premier appel AddData , que le brûleur soit le même que celui utilisé lors de la création d’image précédente.

Si un appel à cette méthode dépasse le nombre de blocs de données disponibles, la méthode retourne IMAPI_E_DISCFULL et ignore toutes les données à ajouter. Cela garantit que le système de fichiers Joliet final n’est pas endommagé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi.h
Bibliothèque	Uuid.lib
DLL	Actxprxy.dll

Voir aussi

IJolietDiscMaster