IFsiDirectoryItem ::Add, méthode (imapi2fs.h)

Article
02/26/2024

Ajoute un fichier ou un répertoire décrit par l’objet IFsiItem à l’image du système de fichiers.

Syntaxe

HRESULT Add(
  [in] IFsiItem *item
);

Paramètres

[in] item

Interface IFsiItem de IFsiFileItem ou IFsiDirectoryItem à ajouter à l’image du système de fichiers.

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
IMAPI_E_INVALID_PATH	Chemin '%1 !s !' est mal formé ou contient des caractères non valides. Valeur : 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE	Impossible de lire les données du flux fourni pour le fichier « %1 !ls ! ». Valeur : 0xC0AAB129
IMAPI_E_DUP_NAME	ls !' name existe déjà. Valeur : 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	Essayez d’ajouter '%1 !ls !' failed : impossible de créer un nom unique spécifique au système de fichiers pour %2 !ls ! . Valeur : 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT	Ajout de '%1 !ls !' entraînerait une image de résultat dont la taille est supérieure à la limite configurée actuelle. Valeur : 0xC0AAB120
IMAPI_E_ISO9660_LEVELS	ISO9660 est limité à 8 niveaux de répertoires. Valeur : 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	Cette image de système de fichiers a trop de répertoires pour %1 !ls ! . Valeur : 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	Le répertoire '%1 !s !' introuvable dans la hiérarchie FileSystemImage. Valeur : 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM	Ce fichier ou répertoire ne fait pas partie du système de fichiers. Il doit être ajouté pour terminer cette opération. Valeur : 0xC0AAB10B
IMAPI_E_READONLY	L’objet FileSystemImage est en mode lecture seule. Valeur : 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT	L’ajout de ce fichier ou répertoire entraînerait une image de résultat dont la taille est supérieure à la limite configurée actuelle. Valeur : 0xC0AAB120
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E

Note Les valeurs retournées par la méthode IUnknown ::QueryInterface peuvent également être retournées ici.

Remarques

Pour créer un élément de répertoire ou un élément de fichier, appelez la méthode IFileSystemImage ::CreateDirectoryItem ou IFileSystemImage ::CreateFileItem , respectivement.

Une fois qu’un élément est ajouté à l’image du système de fichiers, la propriété IFsiFileItem ::get_Data devient en lecture seule.

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

IFsiDirectoryItem

IFsiDirectoryItem ::AddDirectory

IFsiDirectoryItem ::AddFile

IFsiDirectoryItem ::Remove

IFsiFileItem

Partager via