Méthode IFsiNamedStreams::get_Item (imapi2fs.h)

Récupère un flux nommé unique associé à un fichier dans l’image du système de fichiers.

Syntaxe

HRESULT get_Item(
  [in]            LONG          index,
  [out, optional] IFsiFileItem2 **item
);

Paramètres

[in] index

Cette valeur indique la position du flux nommé dans la collection. Le numéro d’index est de base zéro, c’est-à-dire que le premier élément se trouve à l’emplacement 0 de la collection.

[out, optional] item

Pointeur vers un pointeur vers un objet IFsiFileItem2 représentant le flux nommé à la position spécifiée par l’index. Ce paramètre a la valeur NULL si l’index spécifié ne se trouve pas dans la limite de la collection.

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 :

Notes

Si le numéro d’index est négatif ou hors plage, cette méthode retourne le IMAPI_E_INVALID_PARAM.

Pour extraire un énumérateur IEnumVARIANT pour tous les flux nommés associés à un fichier, utilisez la méthode IFsiNamedStreams::get__NewEnum .

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

Voir aussi

IFsiNamedStreams