Método IVssBackupComponentsEx::SetSelectedForRestoreEx (vsbackup.h)
El método SetSelectedForRestoreEx indica si el componente seleccionable especificado está seleccionado para la restauración en una instancia de escritor especificada.
Sintaxis
HRESULT SetSelectedForRestoreEx(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSelectedForRestore,
[in] VSS_ID instanceId
);
Parámetros
[in] writerId
Identificador único global (GUID) de la clase writer.
[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, 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.
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 el método 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.
[in] instanceId
GUID de la instancia de escritor.
El valor predeterminado de este parámetro es GUID_NULL.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se ha indicado correctamente que se ha seleccionado el componente especificado para que se restaure. |
|
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 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. |
|
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. |
|
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. |
|
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
SetSelectedForRestoreEx, que mueve un componente a una instancia de escritor diferente, solo se puede llamar a para un escritor que admita la ejecución de varias instancias de escritor con el mismo identificador de clase y admite un solicitante que mueve un componente a una instancia de escritor diferente en el momento de la restauración. Para determinar si un escritor proporciona esta compatibilidad, llame al método IVssExamineWriterMetadata::GetBackupSchema .
SetSelectedForRestoreEx solo tiene significado para las restauraciones que tienen lugar en el modo de componente.
Solo se puede llamar a SetSelectedForRestoreEx para los componentes que se agregaron explícitamente al documento de copia de seguridad en el momento de la copia de seguridad mediante 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 SetSelectedForRestoreEx 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 del método IVssBackupComponents::AddRestoreSubcomponent ; Esto solo se puede hacer si el componente se puede seleccionar para la restauración (consulte Trabajar con la capacidad de selección y las rutas lógicas).
Se debe llamar a este método antes del método IVssBackupComponents::P reRestore .
La distinción entre los parámetros instanceId y writerID es necesaria porque es posible que varias instancias del mismo escritor se ejecuten en el equipo.
Si el valor del parámetro instanceId es GUID_NULL, equivale a llamar al método IVssBackupComponents::SetSelectedForRestore .
El parámetro instanceId se usa para especificar que el componente se va a restaurar en una instancia de escritor diferente. Si el valor del parámetro instanceId no es GUID_NULL, debe coincidir con el identificador de instancia de una instancia de escritor con el mismo identificador de clase de escritor especificado en el parámetro writerID .
El identificador de clase, el identificador de instancia y el nombre de instancia de un escritor se pueden encontrar llamando al método IVssExamineWriterMetadataEx::GetIdentityEx .
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 con SP1 [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::SetSelectedForRestore