Méthode IFsiNamedStreams::get__NewEnum (imapi2fs.h)
Récupère une liste IEnumVARIANT des flux nommés associés à un fichier dans l’image du système de fichiers.
Syntaxe
HRESULT get__NewEnum(
[out, optional] IEnumVARIANT **NewEnum
);
Paramètres
[out, optional] NewEnum
Pointeur vers un pointeur vers une interface IEnumVariant utilisée pour énumérer les flux nommés associés à un fichier. Les éléments de l’énumération sont des variantes dont le type est VT_BSTR. Utilisez le membre bstrVal pour récupérer le chemin du flux nommé.
Valeur retournée
S_OK est retourné lorsque le nombre d’éléments demandés (celte) est retourné avec succès ou que le nombre d’éléments retournés (pceltFetched) est inférieur au nombre d’éléments demandés. Les paramètres celte et pceltFetched sont définis par IEnumVariant.
D’autres codes de réussite peuvent être retournés suite à 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 |
|---|---|
|
Le pointeur n’est pas valide. |
|
Échec de l’allocation de la mémoire requise. |
Notes
L’énumération est une instantané des flux nommés associés au fichier au moment de l’appel et ne reflète pas les flux nommés qui sont ajoutés ou supprimés ultérieurement.
Pour récupérer un seul flux nommé, utilisez la méthode IFsiNamedStreams::get_Item .
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 |