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