Método IFsiDirectoryItem2::AddTreeWithNamedStreams (imapi2fs.h)
Agrega el contenido de un árbol de directorio junto con secuencias con nombre asociadas a todos los archivos a la imagen del sistema de archivos.
Sintaxis
HRESULT AddTreeWithNamedStreams(
[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. La ruta de acceso solo debe contener caracteres válidos según las convenciones de nomenclatura del sistema de archivos. Este parámetro no puede ser NULL.
[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 o valor devuelto | Descripción |
|---|---|
|
La característica no se admite para la revisión actual del sistema de archivos y, como resultado, se creará sin esta característica. |
|
Valor especificado para el parámetro '%1!ls!' es no válido. |
|
¡ls!' no forma parte del sistema de archivos. Se debe agregar para completar esta operación. |
|
Error al crear el flujo de datos para '%1!ls!'. |
|
No se pueden leer datos de la secuencia proporcionada para el archivo '%1!ls!'. |
|
El objeto IFileSystemImage al que se hace referencia está en modo de solo lectura. |
|
'%1!ls!' el nombre ya existe. |
|
Al agregar '%1!ls!', se produciría un tamaño mayor que el límite configurado actual. |
|
El flujo de datos proporcionado para el archivo '%1!ls!' es incoherente; se esperaba %2! ¡I64d! bytes, encontrado %3! ¡I64d! |
|
No se pudo asignar la memoria necesaria. |
Comentarios
El directorio primario del nuevo subdirectorio ya debe existir dentro de la imagen del sistema de archivos.
La estructura de subdirectorios dentro de sourceDirectory especificada 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.
Si se invoca este método para un objeto de sistema de archivos que no contiene UDF en la lista de sistemas de archivos habilitados para la creación en la imagen resultante o si la revisión de la UDF es inferior a la 2.00, este método devuelve el código correcto IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED. Esto indica que se han agregado las secuencias con nombre, pero no aparecerán en la imagen del sistema de archivos resultante a menos que la revisión UDF 2.00 o posterior esté habilitada en el objeto del sistema de archivos.
Al usar flujos de datos alternativos (ADS), es importante tener en cuenta que la imagen del sistema de archivos tiene una limitación de 1000 secuencias. Si se supera este número, se perderán los datos.
Este método se admite en Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) y Windows Vista a través de Windows Feature Pack para Storage. Todas las características proporcionadas por este paquete de actualización se admiten de forma nativa en Windows 7 y Windows Server 2008 R2.
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 |