Método IVssBackupComponentsEx2::SetAuthoritativeRestore (vsbackup.h)
Marca la restauración de un componente como autoritativo para un almacén de datos replicado.
Sintaxis
HRESULT SetAuthoritativeRestore(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bAuth
);
Parámetros
[in] writerId
Identificador único global (GUID) de la clase writer.
[in] ct
Tipo del componente. Consulte la enumeración 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 la misma que la cadena 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 la cadena que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante el método IVssBackupComponents::AddComponent .
[in] bAuth
Establezca esta variable en true para indicar que la restauración del componente es autoritativa o false en caso contrario.
El valor predeterminado es false.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
La restauración del componente se estableció correctamente en autoritativo o no autenticado. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
No se llamó a este método durante una operación de restauración. |
|
No se encontró el componente especificado. |
|
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
El método SetAuthoritativeRestore solo se puede llamar durante una operación de restauración.
Un escritor indica que admite la restauración autoritativa estableciendo la marca VSS_BS_AUTHORITATIVE_RESTORE en su máscara de esquema de copia de seguridad.
Para obtener más información, vea Establecer opciones de restauración de VSS.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [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::SetRestoreOptions