Método IVssExamineWriterMetadata::GetRestoreMethod (vsbackup.h)

El método GetRestoreMethod devuelve información sobre cómo un escritor quiere que se restauren sus datos.

Sintaxis

HRESULT GetRestoreMethod(
  [out] VSS_RESTOREMETHOD_ENUM *pMethod,
  [out] BSTR                   *pbstrService,
  [out] BSTR                   *pbstrUserProcedure,
  [out] VSS_WRITERRESTORE_ENUM *pwriterRestore,
  [out] bool                   *pbRebootRequired,
  [out] UINT                   *pcMappings
);

Parámetros

[out] pMethod

Puntero a un valor de VSS_RESTOREMETHOD_ENUM que especifica la sobrescritura de archivos, el uso de ubicaciones alternativas que especifican el método que se usará en la operación de restauración.

[out] pbstrService

Si el valor de pMethod es VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, un puntero a una cadena que contiene el nombre del servicio que se inicia y se detiene. De lo contrario, el valor es NULL.

[out] pbstrUserProcedure

Puntero a la dirección URL de un documento HTML o XML que describe al usuario cómo se va a realizar la restauración. El valor puede ser NULL.

[out] pwriterRestore

Puntero a un valor de VSS_WRITERRESTORE_ENUM que especifica si el escritor estará implicado en la restauración de sus datos.

[out] pbRebootRequired

Puntero a un valor booleano que indica si se requerirá un reinicio una vez completada la operación de restauración. El valor recibe true si se requiere un reinicio o false en caso contrario.

[out] pcMappings

Puntero al número de asignaciones alternativas asociadas al escritor.

Valor devuelto

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

Valor	Significado
S_OK	Devolvió correctamente la información del método de restauración.
S_FALSE	Un método de restauración no existe.
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_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

El llamador debe liberar la memoria usada por los parámetros pbstrUserProcedure y pbstrService llamando a SysFreeString.

Siempre se debe restaurar un archivo en su asignación de ubicación alternativa si se cumple alguna de las siguientes condiciones:

• El método de restauración (establecido en el momento de la copia de seguridad) es VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
• Su destino de restauración se estableció (en el momento de la restauración) en VSS_RT_ALTERNATE.

En cualquier caso, si no se define ninguna asignación de ubicación alternativa válida, esto constituye un error de escritor.

Un archivo se puede restaurar en una asignación de ubicación alternativa si :

• El método de restauración se VSS_RME_RESTORE_IF_NOT_THERE y una versión del archivo ya está presente en el disco.
• El método restore es VSS_RME_RESTORE_IF_CAN_REPLACE y una versión del archivo está presente en el disco y no se puede reemplazar.

De nuevo, si no se define ninguna asignación de ubicación alternativa válida, esto constituye un error de escritor.

Una asignación de ubicación alternativa solo se usa durante una operación de restauración y no debe confundirse con una ruta de acceso alternativa, que solo se usa durante una operación de copia de seguridad.

Para obtener más información sobre los métodos de restauración, vea Establecer métodos de restauración de VSS.

Si el método de restauración es VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, un solicitante usa el nombre devuelto por pbstrService para determinar qué servicio se debe detener durante y, a continuación, reiniciar después de la restauración. Consulte Detener servicios para restaurar por solicitantes para obtener información sobre la participación del escritor en la detención y reinicio de los servicios durante una operación de restauración.

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

IVssCreateWriterMetadata::SetRestoreMethod

IVssExamineWriterMetadata