Méthode IFsiFileItem2::RemoveStream (imapi2fs.h)
Supprime une association de flux nommé avec un fichier.
Syntaxe
HRESULT RemoveStream(
[in] BSTR name
);
Paramètres
[in] name
Chaîne qui spécifie le nom de l’association de flux nommé à supprimer. 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.
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 |
|---|---|
|
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é. |
|
Le pointeur n’est pas valide. |
|
Valeur spécifiée pour le paramètre « %1!ls! » est non valide. |
|
ls!' ne fait pas partie du système de fichiers. Il doit être ajouté pour terminer cette opération. |
|
L’objet IFileSystemImage référencé est en mode lecture seule. |
|
Une erreur interne du système de fichiers s’est produite. |
|
'%1!ls!' name existe déjà. |
|
Impossible de lire les données du flux fourni pour le fichier « %1!ls! ». |
|
L’ajout de « %1!ls! » entraînerait une image de résultat ayant une taille supérieure à la limite configurée actuelle. |
|
Le flux de données fourni pour le fichier « %1!ls! » est incohérent ; %2 attendu! I64d! octets, trouvé %3! I64d! |
|
Échec de l’allocation de la mémoire requise. |
Notes
Cette méthode peut être appelée uniquement pour les éléments de fichier présents dans l’image du système de fichiers.
L’utilisateur doit activer la fonction UDF et définir la révision UDF sur 2.00 ou une version ultérieure pour prendre en charge les flux nommés.
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.
Spécifications
| 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 |