Método IVssCreateWriterMetadata::AddDatabaseFiles (vswriter.h)
El método AddDatabaseFiles indica el conjunto de archivos (el archivo o los archivos especificados) que componen la copia de seguridad del componente de base de datos.
Sintaxis
HRESULT AddDatabaseFiles(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszDatabaseName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[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 del componente al que se agregará la base de datos.
Para obtener más información, vea Ruta de acceso lógica de componentes.
No se requiere una ruta de acceso lógica y puede ser NULL.
[in] wszDatabaseName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre de la base de datos.
Este nombre es necesario y debe coincidir con el nombre del componente al que se va a agregar la base de datos.
[in] wszPath
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso del directorio que contiene el archivo de base de datos.
La ruta de acceso puede contener variables de entorno (por ejemplo, %SystemRoot%) pero no puede contener caracteres comodín.
Se admiten rutas unc.
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 del archivo o archivos asociados a la base de datos.
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] dwBackupTypeMask
Máscara de bits (o OR bit a bit) de VSS_FILE_SPEC_BACKUP_TYPE valores de enumeración para indicar si un escritor debe evaluar el archivo para la participación en determinados tipos 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. |
|
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. |
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) a AddDatabaseFiles (después de la resolución de cualquier variable de entorno) deben estar en este formato.
Se puede llamar a este método varias veces para una base de datos determinada. Esto se hace cuando la base de datos existe en archivos almacenados en volúmenes independientes, como es posible con Microsoft SQL Server.
Los valores de los parámetros wszLogicalPath y wszDatabaseName deben coincidir con los de uno de los componentes de base de datos agregados anteriormente con el método IVssCreateWriterMetadata::AddComponent .
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 |