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

Article
02/26/2024

Récupère le répertoire ou l’élément de fichier spécifié à partir de l’image du système de fichiers.

Syntaxe

HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

Paramètres

[in] path

Chaîne qui contient le chemin d’accès à l’élément à récupérer.

[out] item

Interface IFsiItem du répertoire ou de l’élément de fichier demandé.

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
IMAPI_E_INVALID_PATH	Chemin '%1 !s !' est mal formé ou contient des caractères non valides. Valeur : 0xC0AAB110
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
IMAPI_E_INVALID_PARAM	La valeur spécifiée pour le paramètre %1 !ls ! n’est pas valide. Valeur : 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND	Impossible de trouver l’élément %1 !ls ! dans la hiérarchie FileSystemImage. Valeur : 0xC0AAB118
E_OUTOFMEMORY	Échec de l’allocation de la mémoire nécessaire. Valeur : 0x8007000E

Remarques

Pour déterminer si l’élément est un élément de fichier ou un élément de répertoire, appelez la méthode IFsiItem ::QueryInterface en passant __uuidof(IFsiDirectoryItem) comme identificateur d’interface. Si l’appel réussit, l’élément est un élément d’annuaire ; sinon, l’élément est un élément de fichier.

Pour énumérer tous les enfants, appelez la méthode IFsiDirectoryItem ::get__NewEnum .

Configuration requise

Condition requise	Valeur
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

IFsiDirectoryItem

IFsiFileItem

Partager via