Partager via


IFsiDirectoryItem::RemoveTree, méthode (imapi2fs.h)

Supprimez l’arborescence de répertoires spécifiée de l’image du système de fichiers.

Syntaxe

HRESULT RemoveTree(
  [in] BSTR path
);

Paramètres

[in] path

Chaîne qui contient le nom du répertoire à supprimer. Le chemin d’accès est relatif à l’élément de répertoire actif.

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
E_POINTER
Le paramètre path n’est pas un pointeur valide.
IMAPI_E_INVALID_PARAM
La valeur spécifiée pour le paramètre %1!ls! n’est pas valide.

Valeur : 0xC0AAB101

IMAPI_E_INVALID_PATH
Chemin d’accès '%1!s!' est mal formé ou contient des caractères non valides.

Valeur : 0xC0AAB110

IMAPI_E_NOT_IN_FILE_SYSTEM
ls!' ne fait pas partie du système de fichiers. Il doit être ajouté pour terminer cette opération.

Valeur : 0xC0AAB10B

IMAPI_E_READONLY
L’objet FileSystemImage est en mode lecture seule.

Valeur : 0xC0AAB102

IMAPI_E_DIR_NOT_FOUND
Le dossier spécifié n'existe pas.
IMAPI_E_DIR_NOT_EMPTY
Le répertoire %1!s! n’est pas vide.

Valeur : 0xC0AAB10A

IMAPI_E_FSI_INTERNAL_ERROR
Une erreur interne s’est produite : %1!ls!.

Valeur : 0xC0AAB100

IMAPI_E_NOT_DIR
Le chemin d’accès spécifié %1!ls! n’identifie pas de répertoire.

Valeur : 0xC0AAB109

Notes

L’élément de répertoire doit être présent dans l’image du système de fichiers.

Vous pouvez supprimer l’ensemble de l’image du système de fichiers en appelant cette méthode pour l’élément de répertoire racine et en définissant le chemin d’accès à un délimiteur de chemin unique (\).

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

Voir aussi

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove