Método IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)
Agrega un conjunto de archivos (un archivo o archivos especificado) a un componente de grupo de archivos especificado para un escritor rápido.
Sintaxis
HRESULT AddFilesToFileGroup(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszGroupName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszAlternateLocation,
[in] DWORD dwBackupTypeMask
);
Parámetros
[in] wszLogicalPath
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica (que puede ser NULL) del componente al que se van a agregar los archivos. Para obtener más información, vea Ruta de acceso lógica de componentes.
[in] wszGroupName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del componente del grupo de archivos. El tipo de este componente debe ser VSS_CT_FILEGROUP; de lo contrario, el método devolverá un error.
[in] wszPath
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el directorio raíz predeterminado de los archivos que se van a agregar.
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 hasta las aplicaciones que recuperan esta información para comprobar.
[in] wszFilespec
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la especificación de archivo de los archivos que se van a incluir.
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 recorrerá de forma recursiva. Este parámetro debe establecerse en true si la ruta de acceso se trata como una jerarquía de directorios a través de la que se va a recursar o false en caso contrario.
Para obtener información sobre el recorrido por carpetas montadas, vea Trabajar con carpetas montadas y puntos de reanálisis.
[in] wszAlternateLocation
Este parámetro está reservado y debe ser NULL.
[in] dwBackupTypeMask
Máscara de bits de VSS_FILE_SPEC_BACKUP_TYPE valores de enumeración para indicar si un escritor debe evaluar el archivo para la participación en un determinado tipo de operaciones de copia de seguridad.
Este parámetro no puede incluir VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED o VSS_FSBT_LOG_BACKUP_REQUIRED.
El valor predeterminado de este argumento es (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Value | Significado |
|---|---|
|
La operación se realizó correctamente. |
|
Uno de los valores de parámetro no es válido o el autor de la llamada intentó agregar archivos de grupo de archivos a un componente que no es de grupo de archivos. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, vea Control de eventos y errores en VSS. |
|
El componente especificado no existe. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea 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. |
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vswriter.h (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |