Método IVssCreateExpressWriterMetadata::AddExcludeFiles (vswriter.h)
Excluye un conjunto de archivos (un archivo o archivos especificados) que, de lo contrario, podría incluirse implícitamente cuando se realiza una copia de seguridad de un componente de un escritor rápido.
Sintaxis
HRESULT AddExcludeFiles(
[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.
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 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 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. |
|
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
Los escritores express 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 AddExcludeFiles (después de la resolución de cualquier variable de entorno) deben estar en este formato. Por ejemplo, a menudo es conveniente definir un componente para incluir todos los archivos en un directorio especificado y, a continuación, usar AddExcludeFiles para quitar explícitamente algunos archivos (por ejemplo, archivos temporales) de una copia de seguridad.
Para obtener más información sobre la exclusión de archivos, vea Exclude File List Specification.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vswriter.h (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |