Méthode IFsiFileItem2 ::AddStream (imapi2fs.h)

Article
02/27/2024

Associe un flux nommé à un fichier spécifique dans l’image du système de fichiers.

Syntaxe

HRESULT AddStream(
  [in] BSTR    name,
  [in] IStream *streamData
);

Paramètres

[in] name

Une chaîne représente le nom du flux nommé. Cela ne doit pas inclure le chemin d’accès et ne doit contenir que des caractères valides conformément aux conventions de nommage du système de fichiers.

[in] streamData

Interface IStream du flux nommé utilisé pour écrire dans l’image de système de fichiers résultante.

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/valeur de retour	Description
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED Valeur : 0x00AAB15FL	La fonctionnalité n’est pas prise en charge pour la révision actuelle du système de fichiers et, par conséquent, sera créée sans cette fonctionnalité.
E_POINTER Valeur : 0x80004003	Le pointeur n’est pas valide.
IMAPI_E_INVALID_PARAM Valeur : 0xC0AAB101	Valeur spécifiée pour le paramètre « %1 !ls ! » est non valide.
IMAPI_E_NOT_IN_FILE_SYSTEM Valeur : 0xC0AAB10B	ls !' ne fait pas partie du système de fichiers. Il doit être ajouté pour terminer cette opération.
IMAPI_E_READONLY Valeur : 0xC0AAB102	L’objet IFileSystemImage référencé est en mode lecture seule.
IMAPI_E_FSI_INTERNAL_ERROR Valeur : 0xC0AAB100L	Une erreur interne du système de fichiers s’est produite.
IMAPI_E_DUP_NAME Valeur : 0xC0AAB112L	'%1 !ls !' name existe déjà.
IMAPI_E_DATA_STREAM_READ_FAILURE Valeur : 0xC0AAB129L	Impossible de lire les données du flux fourni pour le fichier « %1 !ls ! ».
IMAPI_E_IMAGE_SIZE_LIMIT Valeur : 0xC0AAB120L	L’ajout de « %1 !ls ! » entraînerait une image de résultat ayant une taille supérieure à la limite configurée actuelle.
IMAPI_E_DATA_STREAM_INCONSISTENCY Valeur : 0xC0AAB128L	Le flux de données fourni pour le fichier « %1 !ls ! » est incohérent ; %2 attendu ! I64d ! octets, trouvé %3 ! I64d !
E_OUTOFMEMORY Valeur : 0x8007000EL	Échec de l’allocation de la mémoire requise.

Remarques

Le fichier auquel le flux nommé sera ajouté doit déjà exister dans l’image du système de fichiers. Si cette méthode est appelée avec un nom qui existe déjà pour un flux nommé, elle retourne une erreur et ne remplace pas le flux nommé existant.

Si cette méthode est appelée pour un objet de système de fichiers qui ne contient pas d’UDF dans la liste des systèmes de fichiers activés pour la création dans l’image résultante ou si la révision UDF est inférieure à 2.00, cette méthode retourne le code de réussite IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED. Ce code de réussite indique que le flux nommé a été ajouté, mais qu’il n’apparaîtra pas dans l’image de système de fichiers résultante, sauf si la révision UDF 2.00 ou ultérieure est activée dans l’objet système de fichiers.

Actuellement, IMAPI_E_READONLY est retourné lorsque cette méthode est appelée sur une image de système de fichiers importée, quelle que soit la status en lecture seule de l’image.

Cette méthode est prise en charge dans Windows Server 2003 avec Service Pack 1 (SP1), Windows XP avec Service Pack 2 (SP2) et Windows Vista via le Feature Pack Windows pour le stockage. Toutes les fonctionnalités fournies par ce package de mise à jour sont prises en charge en mode natif dans Windows 7 et Windows Server 2008 R2.

Configuration requise

Condition requise	Valeur
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	imapi2fs.h

Voir aussi

IFsiFileItem2

Partager via