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

Agrega el contenido de un árbol de directorios a la imagen del sistema de archivos.

Sintaxis

HRESULT AddTree(
  [in] BSTR         sourceDirectory,
  [in] VARIANT_BOOL includeBaseDirectory
);

Parámetros

[in] sourceDirectory

Cadena que contiene la ruta de acceso relativa del árbol de directorios que se va a crear.

Especifique la ruta de acceso completa al llamar a este método desde el elemento de directorio raíz.

[in] includeBaseDirectory

Establezca en VARIANT_TRUE para incluir el directorio en sourceDirectory como subdirectorio en la imagen del sistema de archivos. De lo contrario, VARIANT_FALSE.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error 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_OUTOFMEMORY	No se pudo asignar la memoria necesaria. Valor: 0x8007000E
E_POINTER	El puntero no es válido. Valor: 0x80004003
IMAPI_E_DIRECTORY_READ_FAILURE	No se puede acceder a los archivos de enumeración de archivos en el árbol de directorios debido a permisos. Valor: 0xC0AAB12BL
IMAPI_E_DATA_STREAM_CREATE_FAILURE	No se puede acceder a uno o varios de los archivos del árbol de directorios debido a los permisos. Valor: 0xC0AAB12A
IMAPI_E_DATA_STREAM_READ_FAILURE	No se pueden leer datos de la secuencia proporcionada para el archivo '%1!ls!'. Valor: 0xC0AAB129
IMAPI_E_INVALID_PARAM	El valor especificado para el parámetro %1!ls! no es válido. Valor: 0xC0AAB101
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_IMAGE_SIZE_LIMIT	Agregar este archivo o directorio daría lugar a que una imagen de resultado tenga un tamaño mayor que el límite configurado actual. Valor: 0xC0AAB120
IMAPI_E_INVALID_PATH	Ruta de acceso '%1!s!' tiene un formato incorrecto o contiene caracteres no válidos. Valor: 0xC0AAB110
IMAPI_E_DUP_NAME	¡ls!' el nombre ya existe. Valor: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	Intente agregar '%1!ls!' error: no se puede crear un nombre único específico del sistema de archivos para %2!ls! . Valor: 0xC0AAB113
IMAPI_E_ISO9660_LEVELS	ISO9660 está limitado a 8 niveles de directorios. Valor: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	Esta imagen del sistema de archivos tiene demasiados directorios para %1!ls! . Valor: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	El directorio '%1!s!' no se encuentra en la jerarquía FileSystemImage. Valor: 0xC0AAB11A

 

Nota Los valores devueltos por las funciones GetFileAttributesEx y FindFirstFile también se pueden devolver aquí.

 

Comentarios

El directorio primario del nuevo subdirectorio ya debe existir dentro de la imagen del sistema de archivos.

La estructura del subdirectorio dentro del directorio de origen especificado se refleja implícitamente en la imagen del sistema de archivos.

Si se producen colisiones de archivos o directorios, prevalece el contenido del directorio de origen especificado. La imagen del sistema de archivos se sobrescribe con los directorios y archivos adecuados del directorio de origen.

Si se produce una excepción durante el procesamiento, la imagen del sistema de archivos vuelve a su estado anterior.

Requisitos

Requisito	Value
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::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove