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

  • Artículo

El método AddDatabaseLogFiles indica los archivos de registro asociados a una base de datos de la que se va a realizar una copia de seguridad, así como su ubicación.

Sintaxis

HRESULT AddDatabaseLogFiles(
  [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 de base de datos al que se agregarán los archivos de registro.

Para obtener más información, consulte 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 del componente de base de datos asociado a los archivos de registro. El tipo de este componente debe ser VSS_CT_DATABASE; de lo contrario, el método devolverá un error.

[in] wszPath

Puntero a una cadena de caracteres anchos terminada en null que contiene la ruta de acceso del directorio que contiene los archivos de registro.

El directorio puede ser un directorio local en la máquina VSS o puede ser un directorio de recursos compartidos de archivos en un servidor de archivos remoto.

Se admiten rutas de acceso UNC.

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

Puntero a una cadena de caracteres anchos terminada en NULL que contiene la especificación de archivo de los archivos de registro 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 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
S_OK
 La operación se realizó correctamente.
E_INVALIDARG
 Uno de los valores de parámetro no es válido o el autor de la llamada intentó agregar archivos de base de datos a un componente que no es de base de datos.
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, consulte 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, 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

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 pueden ser una unidad de red asignada. Por lo tanto, las entradas de ruta de acceso (wszPath) a AddDatabaseLogFiles (después de la resolución de cualquier variable de entorno) deben estar en este formato.

Este método se puede llamar varias veces para un componente de base de datos determinado, que puede ser necesario cuando varios archivos de registro se almacenan en volúmenes independientes.

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

   
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 (incluya Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent