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

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 .

• IVssExamineWriterMetadata::GetExcludeFile
• IVssWMComponent::GetDatabaseFile
• IVssWMComponent::GetDatabaseLogFile
• IVssWMComponent::GetFile

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