Método IVssCreateWriterMetadata::AddFilesToFileGroup (vswriter.h)
El método AddFilesToFileGroup agrega un conjunto de archivos (un archivo o archivos especificados) a un componente de grupo de archivos especificado.
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.
El directorio puede ser un directorio local en el equipo VSS o puede ser un directorio de recursos compartidos de archivos en un servidor de archivos remoto.
Se admiten rutas unc.
La ruta de acceso puede contener variables de entorno (por ejemplo, %SystemRoot%) pero no puede contener caracteres comodín.
No hay ningún requisito de 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
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso alternativa, que contiene realmente los archivos de los que se va a realizar una copia de seguridad con este componente.
El directorio puede ser un directorio local en el equipo VSS o puede ser un directorio de recursos compartidos de archivos en un servidor de archivos remoto.
Se admiten rutas unc.
Especificar una ruta alternativa es opcional; si no se necesita ninguna ruta de acceso alternativa, wszAlternatePath debe ser NULL.
Una ruta de acceso alternativa no debe confundirse con una asignación de ubicación alternativa.
[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.
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.
| Valor | 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. |
|
En el caso de los escritores rápidos, el valor de wszAlternatePath debe ser NULL y la máscara de bits dwBackupTypeMask no puede incluir VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED o VSS_FSBT_LOG_BACKUP_REQUIRED. |
|
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. |
Comentarios
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: Los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012. Los escritores solo admiten recursos locales: conjuntos de archivos cuya ruta de acceso absoluta comienza con una especificación de volumen local válida y no puede ser una unidad de red asignada. Por lo tanto, las entradas de ruta de acceso (wszPath y wszAlternatePath) a AddFilesToFileGroup (después de la resolución de cualquier variable de entorno) deben tener este formato.
Un escritor puede llamar a este método varias veces para agregar varios conjuntos de archivos a su componente de grupo de archivos. Sin embargo, debe asegurarse de que las especificaciones de archivo no se superponen, ya que un archivo determinado solo se puede especificar una vez.
Las ubicaciones desde las que se realiza una copia de seguridad de los archivos y en las que se restauran dependen de los valores del directorio raíz definido por wszPath y de la ruta de acceso alternativa definida por wszAlternatePath.
Tenga en cuenta lo siguiente al usar la información de ruta de acceso proporcionada por AddFilesToFileGroup:
- Las operaciones de restauración deben (si es posible) restaurar archivos agregados a un componente por AddFilesToFileGroup en el directorio raíz predeterminado definido por wszPath.
- Si no se especifica una ruta de acceso alternativa (si wszAlternatePath es NULL), se realizará una copia de seguridad de los archivos agregados al componente desde el directorio raíz predeterminado y se restaurará en el directorio raíz predeterminado indicado por wszPath.
- Si se especifica una ruta de acceso alternativa (si wszAlternatePath no es NULL), se realiza una copia de seguridad de los archivos agregados al componente desde la ruta de acceso alternativa especificada por wszAlternatePath. Sin embargo, los solicitantes seguirán usando wszPath como ubicación de restauración predeterminada.
- Si se define la ruta de acceso alternativa (wszAlternatePath no es NULL) y hay archivos que coinciden con la especificación de archivo (wszFilespec) tanto en la ruta de acceso alternativa como en el directorio raíz predeterminado (wszPath), una operación de copia de seguridad debe hacer una copia de seguridad de los archivos ubicados en la ruta de acceso alternativa, no los archivos ubicados en el directorio raíz predeterminado.
- Los archivos se deben restaurar en el directorio indicado por wszPath a menos que IVssCreateWriterMetadata::AddAlternateLocationMapping establezca una asignación de ubicación alternativa y el método de restauración o destino de restauración lo requiera.
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 | vswriter.h (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |