Método IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot (vswriter.h)
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 |
|---|---|
|
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. |
|
Este método no se admite para escritores rápidos. |
|
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