Método IVssWMFiledesc::GetAlternateLocation (vswriter.h)

  • Artículo

El método GetAlternateLocation obtiene una ubicación alternativa para un conjunto de archivos.

Sintaxis

HRESULT GetAlternateLocation(
  [out] BSTR *pbstrAlternateLocation
);

Parámetros

[out] pbstrAlternateLocation

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que especifica la ubicación de copia de seguridad alternativa. La ruta de acceso de esta ubicación puede ser una ruta de acceso local o la ruta de acceso UNC de un recurso compartido de archivos remoto. Si no hay ninguna ubicación alternativa, el puntero es NULL.

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 de ubicación alternativa.
S_FALSE
 No se encontró la información solicitada.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: Los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012.

El autor de la llamada debe llamar a SysFreeString para liberar la memoria que mantiene el parámetro pbstrAlternateLocation .

La interpretación de la ubicación alternativa devuelta por GetAlternateLocation difiere en función del método utilizado para recuperar el objeto IVssWMFiledesc .

El valor devuelto por GetAlternateLocation hace referencia a una asignación de ubicación alternativa cuando la devuelve el método IVssExamineWriterMetadata::GetAlternateLocationMapping .

Durante las operaciones de copia de seguridad, se trata de la ubicación alternativa desde la que se va a realizar una copia de seguridad de un archivo. Durante una restauración, es la ubicación alternativa a la que se va a restaurar un archivo.

Para obtener más información, vea Ubicaciones de copia de seguridad y restauración no predeterminadas.

Requisitos

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

Consulte también

IVssWMFiledesc