Compartir a través de

Método IFsiDirectoryItem::RemoveTree (imapi2fs.h)

  • Artículo

Quite el árbol de directorios especificado de la imagen del sistema de archivos.

Sintaxis

HRESULT RemoveTree(
  [in] BSTR path
);

Parámetros

[in] path

Cadena que contiene el nombre del directorio que se va a quitar. La ruta de acceso es relativa al elemento de directorio actual.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_POINTER
 El parámetro path no es un puntero válido.
IMAPI_E_INVALID_PARAM
 El valor especificado para el parámetro %1!ls! no es válido.

Valor: 0xC0AAB101
IMAPI_E_INVALID_PATH
 Ruta de acceso '%1!s!' tiene un formato incorrecto o contiene caracteres no válidos.

Valor: 0xC0AAB110
IMAPI_E_NOT_IN_FILE_SYSTEM
 ¡ls!' no forma parte del sistema de archivos. Se debe agregar para completar esta operación.

Valor: 0xC0AAB10B
IMAPI_E_READONLY
 El objeto FileSystemImage está en modo de solo lectura.

Valor: 0xC0AAB102
IMAPI_E_DIR_NOT_FOUND
 El directorio especificado no existe.
IMAPI_E_DIR_NOT_EMPTY
 El directorio %1!s! no está vacío.

Valor: 0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR
 Error interno: %1!ls!.

Valor: 0xC0AAB100
IMAPI_E_NOT_DIR
 La ruta de acceso especificada %1!ls! no identifica un directorio.

Valor: 0xC0AAB109

Comentarios

El elemento de directorio debe estar presente en la imagen del sistema de archivos.

Puede eliminar toda la imagen del sistema de archivos llamando a este método para el elemento de directorio raíz y estableciendo la ruta de acceso en un delimitador de ruta de acceso única (\).

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove