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

El método SetSelectedForRestore indica si el componente seleccionable especificado está seleccionado para la restauración.

Sintaxis

HRESULT SetSelectedForRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bSelectedForRestore
);

Parámetros

[in] writerId

Identificador de escritor.

[in] ct

Tipo del componente. Consulte VSS_COMPONENT_TYPE para conocer los valores posibles.

[in] wszLogicalPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente. Para obtener más información, vea 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.

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.

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] bSelectedForRestore

Si el valor de este parámetro es true, se ha seleccionado el componente seleccionado para la restauración. Si el valor es false, el componente seleccionado no se ha seleccionado para la restauración.

Valor devuelto

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

Valor	Significado
S_OK	Se ha indicado correctamente que se ha seleccionado el componente especificado para que se restaure.
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, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta.
VSS_E_OBJECT_NOT_FOUND	El componente que se selecciona no existe en el documento Componentes de copia de seguridad o en una instancia activa del escritor correspondiente a ese componente no se está ejecutando en el 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, vea 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, 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

SetSelectedForRestore solo tiene significado para las restauraciones que tienen lugar en el modo de componente.

Solo se puede llamar a SetSelectedForRestore para los componentes que se agregaron explícitamente al documento de copia de seguridad en el momento de la copia de seguridad mediante IVssBackupComponents::AddComponent. Para restaurar un componente que se seleccionó implícitamente para la copia de seguridad como parte de un conjunto de componentes, debe llamar a SetSelectedForRestore en el componente antecesor más cercano que se agregó al documento. Si solo se van a restaurar los datos de este componente, debe realizarse a través de IVssBackupComponents::AddRestoreSubcomponent; Esto solo se puede hacer si el componente se puede seleccionar para la restauración (consulte Working with Selectability and Logical Paths [Trabajar con la selectibilidad y las rutas lógicas]).

Se debe llamar a este método antes de IVssBackupComponents::P reRestore.

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	vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssBackupComponents

IVssBackupComponents::P reRestore

IVssComponent::IsSelectedForRestore

VSS_COMPONENT_TYPE