Método IVssComponent::AddPartialFile (vswriter.h)

El método AddPartialFile indica que solo se va a realizar una copia de seguridad de partes de un archivo determinado y cuáles son las partes.

Solo un escritor puede llamar a este método y solo durante una operación de copia de seguridad.

Sintaxis

HRESULT AddPartialFile(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilename,
  [in] LPCWSTR wszRanges,
  [in] LPCWSTR wszMetadata
);

Parámetros

[in] wszPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso del archivo implicado en operaciones de archivos parciales.

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 hasta las aplicaciones que recuperan esta información para comprobar.

Esta ruta de acceso debe coincidir o estar debajo de la ruta de acceso de un conjunto de archivos ya en el componente (o uno de sus subcomponentes si el componente define un conjunto de componentes).

[in] wszFilename

Cadena de caracteres anchos terminada en NULL que contiene el nombre del archivo implicado en operaciones parciales de archivos. El nombre del archivo (wszFilename) no puede contener caracteres comodín (* o ?) y debe ser coherente con la especificación de archivo de un conjunto de archivos que contiene la ruta de acceso de origen (wszPath).

[in] wszRanges

Cadena de caracteres anchos terminada en NULL que contiene una lista de desplazamientos y longitudes de archivo que componen el intervalo de compatibilidad parcial de archivos (las secciones del archivo de las que se va a hacer una copia de seguridad realmente) o el nombre de un archivo que contiene dicha lista.

Se requiere especificar el intervalo de compatibilidad de archivos parcial y este valor no puede ser NULL.

[in] wszMetadata

Cadena de caracteres anchos terminada en NULL que contiene los metadatos adicionales requeridos por un escritor para validar una operación de restauración de archivos parcial. La información de esta cadena de metadatos será opaca para los solicitantes.

Si no se requieren metadatos adicionales, este valor puede ser NULL.

Valor devuelto

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

Valor	Significado
S_OK	Establezca correctamente el elemento.
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_BAD_STATE	Un escritor no llamó al método o, si lo llama un escritor, no se llamó durante una operación de restauración.

Comentarios

Solo un escritor puede llamar a este método y el escritor no puede llamar a este método durante una operación de restauración.

La sintaxis de la lista de intervalos (wszRanges) es la de una lista separada por comas del formulario offset1:length1, offset2:length2, donde cada desplazamiento y longitud es un entero de 64 bits que especifica un desplazamiento de bytes y una longitud en bytes, respectivamente. El desplazamiento y la longitud se pueden expresar como valores hexadecimales o decimales.

Si wszRange hace referencia a un archivo que contiene todos los desplazamientos y longitudes (un archivo ranges), wszRange contendrá solo la ruta de acceso completa al archivo.

Un archivo ranges debe ser un archivo binario con el siguiente formato:

1. Entero de 64 bits que indica el número de intervalos de archivos distintos de los que se debe realizar una copia de seguridad
2. Cada intervalo expresado como un par de enteros de 64 bits: el desplazamiento en el archivo del que se realiza una copia de seguridad en bytes y la longitud de los datos a partir de ese desplazamiento de los que se va a hacer una copia de seguridad

En cualquier caso, un intervalo indica una subsección de un archivo determinado del que se va a realizar una copia de seguridad, independientemente del resto del archivo.

Los solicitantes pueden recuperar la información de archivo parcial mediante IVssComponent::GetPartialFile y usar la información de desplazamiento y longitud devuelta por GetPartialFile para restaurar secciones de copia de seguridad en la ubicación adecuada dentro de la copia del archivo en el disco en el momento de la restauración.

AddPartialFile se puede aplicar a un archivo ya administrado por el componente (o uno de sus subcomponentes si el componente define un conjunto de componentes), o puede agregar un nuevo archivo al componente e indicar que participará en operaciones de archivo parciales.

Al indicar que el archivo que va a participar es un archivo nuevo, ese archivo debe existir en un volumen copiado en sombra y su ruta de acceso (wszPath) debe coincidir o estar debajo de una ruta de acceso ya en el componente (o uno de sus subcomponentes si el componente define un conjunto de componentes). Sin embargo, la especificación de archivo del archivo (wszFileSpec) no debe coincidir con una de los componentes.

Los archivos recién agregados no admitirán asignaciones de ubicación alternativas.

Requisitos

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

Consulte también

IVssBackupComponents::SetRangesFilePath

IVssComponent

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount