Compartir a través de

Método IFileSystemImage::p ut_StageFiles (imapi2fs.h)

  • Artículo

Determina si los archivos que se agregan a la imagen del sistema de archivos se deben almacenar provisionalmente antes de la grabación.

Sintaxis

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Parámetros

[in] newVal

Establézcalo en VARIANT_TRUE para forzar que los archivos agregados a la imagen del sistema de archivos se almacenen provisionalmente en uno o varios archivos de fase antes de grabar. De lo contrario, establezca en VARIANT_FALSE si no se requiere almacenamiento provisional y se desea un mayor rendimiento.

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_NOTIMPL
 Sin implementar.

Valor: 0x80004001

Comentarios

"Ensayo" es un proceso en el que se crea una imagen en el disco duro, que contiene todos los archivos que se van a grabar, antes de iniciar la operación de grabación.

Establecer esta propiedad en VARIANT_TRUE solo afectará a los archivos que se agregan después de establecer la propiedad: esos archivos siempre se almacenarán provisionalmente. Los archivos que no se almacenaron provisionalmente antes de un valor de propiedad especificado de VARIANT_TRUE, no se almacenarán provisionalmente.

Al especificar VARIANT_FALSE, el proceso de creación de imágenes del sistema de archivos se optimiza de dos maneras:

  • Se requiere menos tiempo para la generación de imágenes
  • IMAPI consume menos espacio en un disco local
Sin embargo, para evitar problemas de saturación del búfer durante la quema, se requiere un determinado rendimiento mínimo para las operaciones de lectura en archivos no almacenados provisionalmente. En caso de que la accesibilidad o el rendimiento de los archivos no cumplan los requisitos del quemador, IMAPI aplica el almacenamiento provisional de archivos independientemente del valor de propiedad especificado. Por ejemplo, el almacenamiento provisional de archivos se aplica para los archivos de origen de dispositivos de almacenamiento extraíbles, como el disco flash USB.

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

IFileSystemImage

IFileSystemImage::get_StageFiles