Partager via


IFileSystemImage::CreateFileItem, méthode (imapi2fs.h)

Créez un élément de fichier avec le nom spécifié.

Syntaxe

HRESULT CreateFileItem(
  [in]  BSTR         name,
  [out] IFsiFileItem **newItem
);

Paramètres

[in] name

Chaîne qui contient le nom de l’élément de fichier à créer.

[out] newItem

Interface IFsiFileItem du nouvel élément de fichier. Lorsque vous avez terminé, appelez la méthode IFsiFileItem::Release pour libérer l’interface.

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_PARAM
Le nom fourni n’est pas valide.

Valeur : 0xC0AAB101

E_OUTOFMEMORY
Impossible d’allouer la mémoire requise.

Valeur : 0x8007000E

Notes

Après avoir défini les propriétés sur l’interface IFsiFileItem , appelez la méthode IFsiDirectoryItem::Add sur l’élément de répertoire parent pour l’ajouter à l’image du système de fichiers.

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 imapi2fs.h

Voir aussi

IFileSystemImage

IFsiFileItem