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

Article
08/24/2023

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