Método IVssComponent::AddDifferencedFilesByLastModifyTime (vswriter.h)
Un escritor usa el método AddDifferencedFilesByLastModifyTime para indicar que se debe evaluar un conjunto de archivos (un archivo o archivos especificado) con una marca de tiempo de última modificación para su inclusión en una copia de seguridad incremental o diferencial con marca de tiempo mediante archivos completos, no archivos parciales.
Un escritor solo puede llamar a este método durante una operación de copia de seguridad.
Sintaxis
HRESULT AddDifferencedFilesByLastModifyTime(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] BOOL bRecursive,
[in] FILETIME ftLastModifyTime
);
Parámetros
[in] wszPath
Cadena de caracteres anchos terminada en NULL que contiene el nombre del directorio o la jerarquía de directorios que contiene los archivos que se van a asignar.
La ruta de acceso puede contener variables de entorno (por ejemplo, %SystemRoot%) pero no puede contener caracteres comodín.
No es necesario que la ruta de acceso termine con una barra diagonal inversa (""). Es necesario que las aplicaciones recuperen esta información para comprobarla.
[in] wszFilespec
Cadena de caracteres anchos terminada en NULL que contiene la especificación de archivo de los archivos que se van a asignar.
Una especificación de archivo no puede contener especificaciones de directorio (por ejemplo, sin barras diagonales inversas), pero puede contener ? y * caracteres comodín.
[in] bRecursive
Valor booleano que especifica si la ruta de acceso especificada por el parámetro wszPath identifica solo un único directorio o si indica una jerarquía de directorios que se va a recorrer de forma recursiva. Este parámetro debe establecerse en true si la ruta de acceso se trata como una jerarquía de directorios que se recorrerá de forma recursiva o false si no es así .
Para obtener información sobre cómo recorrer carpetas montadas, vea Trabajar con carpetas montadas y puntos de reanálisis.
[in] ftLastModifyTime
Especificación del escritor de la hora de la última modificación de los archivos de diferencia, expresados como una estructura FILETIME .
La hora de última modificación siempre se da en hora media de Greenwich.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
Valor | Significado |
---|---|
|
Se agregaron archivos con diferencias correctamente. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
Un escritor no llamó a este método o, si lo llama un escritor, no se llamó durante una operación de copia de seguridad o se llamó al controlar un evento BackupComplete o BackupShutdown . |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar. |
Comentarios
Un escritor llama a este método para especificar que se debe realizar una copia de seguridad de determinados archivos de un componente solo si se han modificado desde un momento determinado. Para obtener más información, vea Copia de seguridad por hora de última modificación.
Solo los escritores que admiten el esquema modificado (VSS_BS_LAST_MODIFY) pueden llamar a este método y solo durante las operaciones de copia de seguridad. Los escritores que usan este método no tienen que admitir el esquema de marca de tiempo (VSS_BS_TIMESTAMPED).
Los archivos agregados por AddDifferencedFilesByLastModifyTime no deben agregarse también por IVssComponent::AddPartialFile.
Si el tipo de copia de seguridad (VSS_BACKUP_TYPE) es incremental (VSS_BT_INCREMENTAL), los escritores que usan AddDifferencedFilesByLastModifyTime deben admitir el esquema incremental (VSS_BS_INCREMENTAL). Si el tipo de copia de seguridad es diferencial, el escritor debe admitir el esquema de VSS_BS_DIFFERENTIAL .
Se debe llamar al método AddDifferencedFilesByLastModifyTime antes del inicio real de una operación de copia de seguridad, normalmente mientras se controla el evento PostSnapshot (consulte CVssWriter::OnPostSnapshot).
Si el valor de marca de tiempo establecido por AddDifferencedFilesByLastModifyTime es distinto de cero, un solicitante debe respetar este valor independientemente de sus propios registros e información del sistema de archivos al determinar si el archivo diferenciado debe incluirse en una copia de seguridad diferencial o incremental.
Si la marca de tiempo establecida por AddDifferencedFilesByLastModifyTime (ftLastModifyTime) es cero, el solicitante puede usar información del sistema de archivos y sus propios registros para determinar si los archivos diferenciados deben incluirse en una copia de seguridad diferencial o incremental.
Los solicitantes recuperan el número de archivos diferenciados administrados por un componente mediante una llamada a IVssComponent::GetDifferencedFile.
Los conjuntos de archivos con diferencias pueden ser cualquiera de los siguientes:
- Miembro del componente actual o (si el componente define un conjunto de componentes) sus subcomponentes
- Nuevos archivos no incluidos anteriormente en los componentes o subcomponentes. El método AddDifferencedFilesByLastModifyTime permite a los escritores indicar que los archivos creados desde la copia de seguridad original deben incluirse en el componente para admitir copias de seguridad incrementales o diferenciales.
Al agregar nuevos archivos al componente , AddDifferencedFilesByLastModifyTime, el escritor no debe agregar archivos administrados por otro componente o escritor.
No hay ningún método en la interfaz IVssComponent que permita cambiar o agregar asignaciones de ubicación alternativas para los nuevos archivos agregados por AddDifferencedFilesByLastModifyTime. Si una asignación de ubicación alternativa corresponde al nuevo archivo, se usará esa ubicación alternativa.
Requisitos
Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | vswriter.h (incluya Vss.h, VsWriter.h) |
Library | VssApi.lib |
Consulte también
IVssComponent::GetDifferencedFile
IVssComponent::GetDifferencedFilesCount