Compartir a través de

Método IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot (vswriter.h)

  • Artículo

Notifica los conjuntos de archivos que el escritor excluirá explícitamente cuando se cree una instantánea.

Llamar a este método no hace que se excluyan los archivos. El escritor es responsable de eliminar los archivos de la instantánea en su método CVssWriter::OnPostSnapshot .

Sintaxis

HRESULT AddExcludeFilesFromSnapshot(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

Parámetros

[in] wszPath

Puntero a una cadena de caracteres anchos terminada en NULL que contiene el directorio raíz en el que se excluirán los archivos.

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 necesario que las aplicaciones recuperen esta información para comprobar si la ruta de acceso termina con una barra diagonal inversa.

[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 excluir.

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.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
0x00000000L
 La operación se realizó correctamente.
E_INVALIDARG
0x80070057L
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
0x8007000EL
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 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_NOT_SUPPORTED
0x8004232FL
 Este método no se admite para escritores rápidos.
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.

El uso del método AddExcludeFilesFromSnapshot es opcional. Los escritores solo deben usar este método para archivos grandes que cambian significativamente entre las operaciones de instantáneas.

Este método no es un sustituto del método IVssCreateWriterMetadata::AddExcludeFiles . Los escritores deben seguir usando el método AddExcludeFiles para informar de qué conjuntos de archivos se excluyen de la copia de seguridad.

El autor de la llamada es responsable de llamar al método IUnknown::Release para liberar los recursos del objeto IVssWMFiledesc devuelto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vswriter.h (incluye Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssCreateWriterMetadata::AddExcludeFiles

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile