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

  • Artículo

El método AddExcludeFiles se usa para excluir explícitamente un conjunto de archivos (un archivo o archivos especificado) que, de lo contrario, podría incluirse implícitamente cuando se realiza una copia de seguridad de un componente del escritor actual.

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.

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 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 va a 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 la que se va a recurse o false de lo contrario.

Para obtener información sobre cómo recorrer 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.

Value 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, consulte Control de eventos y errores en VSS.
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 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 determinado 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 Excluir especificación de lista de archivos.

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