Método IVssCreateWriterMetadata::AddDatabaseFiles (vswriter.h)

  • Artículo

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
S_OK
 La operación se realizó correctamente.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
 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.
VSS_E_OBJECT_NOT_FOUND
 El componente especificado no existe.
VSS_E_UNEXPECTED
 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

Consulte también

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent