Méthode IFsiDirectoryItem::get__NewEnum (imapi2fs.h)
Récupère une liste d’éléments enfants contenus dans le répertoire dans l’image du système de fichiers.
Syntaxe
HRESULT get__NewEnum(
[out] IEnumVARIANT **NewEnum
);
Paramètres
[out] NewEnum
Interface IEnumVariant que vous utilisez pour énumérer les éléments enfants contenus dans le répertoire. 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 d’accès à l’élément enfant.
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 de retour | Description |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Échec de l’allocation de la mémoire nécessaire.
Valeur : 0x8007000E |
Notes
L’énumération est une instantané des enfants contenus dans le répertoire au moment de l’appel et ne reflète pas les enfants ajoutés et supprimés.
Pour récupérer un seul élément, consultez la propriété IFsiDirectoryItem::get_Item .
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 |