Compartir a través de


Método IVssComponentEx::GetRestoreName (vswriter.h)

Obtiene el nombre lógico asignado a un componente que se está restaurando.

Sintaxis

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

Parámetros

[out] pbstrName

Dirección de una variable asignada por el autor de la llamada que recibe una cadena de caracteres anchos terminada en NULL que contiene el nombre de restauración del componente.

Valor devuelto

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

Valor Significado
S_OK
La operación se realizó correctamente.
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.

Comentarios

Solo se puede llamar al método GetRestoreName durante una operación de restauración.

Si la llamada a GetRestoreName se realiza correctamente, el autor de la llamada es responsable de liberar la cadena que se devuelve en el parámetro pbstrName mediante una llamada a la función SysFreeString .

Un escritor indica que admite este método estableciendo la marca VSS_BS_RESTORE_RENAME 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

Requisito Value
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 vswriter.h (incluye Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssBackupComponentsEx2::SetRestoreName

IVssComponentEx

VSS_BACKUP_SCHEMA