Método IVssBackupComponents::SetRangesFilePath (vsbackup.h)

El método SetRangesFilePath se usa cuando una operación de archivo parcial requiere un archivo ranges y ese archivo se ha restaurado en una ubicación distinta de la original.

Sintaxis

HRESULT SetRangesFilePath(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] UINT               iPartialFile,
  [in] LPCWSTR            wszRangesFile
);

Parámetros

[in] writerId

Identificador único global (GUID) de la clase writer que contiene los archivos implicados en la operación de archivo parcial.

[in] ct

Identifica el tipo del componente. Consulte VSS_COMPONENT_TYPE para conocer los posibles valores devueltos.

[in] wszLogicalPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente que contiene los archivos que participan en la operación de archivo parcial.

Para obtener más información, consulte Ruta de acceso lógica de componentes.

El valor de la cadena que contiene la ruta de acceso lógica usada aquí debe ser el mismo que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

La ruta de acceso lógica puede ser NULL.

No hay restricciones en los caracteres que pueden aparecer en una ruta lógica que no sea NULL .

[in] wszComponentName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del componente que contiene los archivos que participan en la operación de archivo parcial.

La cadena no puede ser NULL y debe contener el mismo nombre de componente que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

[in] iPartialFile

Número de índice del archivo parcial. El valor de este parámetro es un entero comprendido entre 0 y n-1 inclusive, donde n es el número total de archivos parciales asociados a un componente determinado. IVssComponent::GetPartialFileCount devuelve el valor de n.

[in] wszRangesFile

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso completa de un archivo de rangos.

Valor devuelto

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

Valor	Significado
S_OK	Se agregó correctamente el nuevo destino de restauración.
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	El objeto de componentes de copia de seguridad no se inicializa o se ha llamado a este método distinto de durante una operación de restauración.
VSS_E_OBJECT_NOT_FOUND	El componente no existe o la ruta de acceso y la especificación de archivo no coinciden con una especificación de componente y archivo en el componente.
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

No es necesario llamar a SetRangesFilePath si los archivos de intervalos se restauran en su lugar.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssBackupComponents

IVssComponent::AddPartialFile

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount