Método IJolietDiscMaster::AddData (imapi.h)
Agrega el contenido de un almacenamiento raíz al archivo de imagen almacenado provisionalmente. Este almacenamiento se enumerará para colocar todos los substorages y secuencias en el sistema de archivos raíz del archivo de imagen de fase. Los substorages se convierten en carpetas y secuencias se convierten en archivos. Se pueden repetir varias llamadas a este método para almacenar provisionalmente lentamente un archivo de imagen sin perder cantidades innecesarias de espacio en el disco duro que crea un archivo de almacenamiento.
Sintaxis
HRESULT AddData(
[in] IStorage *pStorage,
[in] long lFileOverwrite
);
Parámetros
[in] pStorage
Ruta de acceso al almacenamiento cuyos subelementos se van a agregar a la raíz del archivo de imagen almacenado provisionalmente.
[in] lFileOverwrite
Si este parámetro es distinto de cero, sobrescriba los archivos existentes con el mismo nombre. De lo contrario, el último archivo agregado aparece en el directorio .
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:
Comentarios
Al repetir una operación AddData , las carpetas con archivos duplicados provocan una prueba de lFileOverwrite. Si la marca es distinta de cero, el archivo se sobrescribe. Los archivos anteriores con nombres en conflicto todavía se escriben en el disco del archivo de imagen. Si lFileOverwrite es cero y existe un archivo con el mismo nombre, Se produce un error en AddData con IMAPI_E_FILEEXISTS.
Aunque se puede llamar a AddData varias veces después de llamar a IDiscMaster::SetActiveDiscRecorder, se debe llamar a SetActiveDiscRecorder cada vez que se inicie una nueva imagen e inmediatamente antes de la primera llamada AddData , independientemente de si el quemador es el mismo usado en la creación de la imagen anterior.
Si una llamada a este método superaría el número de bloques de datos disponibles, el método devuelve IMAPI_E_DISCFULL y omite todos los datos que se van a agregar. Esto garantiza que el sistema de archivos final de Dockert no esté dañado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi.h |
| Library | Uuid.lib |
| Archivo DLL | Actxprxy.dll |