Compartir a través de

Método IFileSystemImage::get_StageFiles (imapi2fs.h)

  • Artículo

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

Sintaxis

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Parámetros

[out] pVal

VARIANT_TRUE si los archivos que se agregan a la imagen del sistema de archivos deben almacenarse provisionalmente en uno o varios archivos de fase antes de grabar. De lo contrario, se devuelve VARIANT_FALSE si IMAPI puede optimizar el proceso de creación de imágenes sin almacenar provisionalmente los archivos que se agregan a la imagen del sistema de archivos.

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 puntero no es válido.

Valor: 0x80004003

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 a través de IFileSystemImage::p ut_StageFiles 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::p ut_StageFiles