Método IVssComponent::GetAlternateLocationMapping (vswriter.h)
GetAlternateLocationMapping se usa para devolver la ubicación alternativa de un conjunto de archivos para la restauración de archivos. Un escritor o un solicitante pueden llamar a este método.
Sintaxis
HRESULT GetAlternateLocationMapping(
[in] UINT iMapping,
[out] IVssWMFiledesc **ppFiledesc
);
Parámetros
[in] iMapping
Índice de una asignación determinada. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de asignaciones de ubicación alternativas asociadas al componente actual. IVssComponent::GetAlternateLocationMappingCount devuelve el valor de n.
[out] ppFiledesc
Puntero indirecto doble a un objeto IVssWMFiledesc que contiene la información de asignación.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se devolvió correctamente el valor del atributo. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, vea Control de eventos y errores en VSS. |
|
No se encontró el elemento especificado. |
Comentarios
Las asignaciones de ubicación alternativas devueltas por GetAlternateLocationMapping no solo pueden provenir de archivos del componente actual, sino también de archivos de cualquiera de sus subcomponentes no seleccionables.
El valor devuelto por IVssComponent::GetAlternateLocationMapping tampoco debe confundirse con el devuelto por IVssExamineWriterMetadata::GetAlternateLocationMapping:
- IVssExamineWriterMetadata::GetAlternateLocationMapping es la asignación de ubicación alternativa a la que se puede restaurar un archivo si es necesario.
- IVssComponent::GetAlternateLocationMapping es la ubicación alternativa a la que se restauró un archivo de hecho.
- El método de restauración (establecido en el momento de la copia de seguridad) se VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
- Su destino de restauración se estableció (en el momento de la restauración) en VSS_RT_ALTERNATE.
Un archivo se puede restaurar en una asignación de ubicación alternativa si se cumple alguna de las siguientes condiciones:
- El método de restauración es 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.
La asignación devuelta por GetAlternateLocationMapping hace referencia a las asignaciones de ubicación alternativas que se usan en el transcurso de la restauración de archivos.
Las asignaciones de ubicación alternativas se agregan a un objeto IVssComponent por IVssBackupComponents::AddAlternativeLocationMapping.
El llamador debe llamar a IUnknown::Release para liberar los recursos del sistema mantenidos por el parámetro ppMapping cuando se realiza con el objeto IVssWMFiledesc al que apunta.
Para obtener más información sobre las ubicaciones de archivos de copia de seguridad y restauración en VSS, consulte Ubicaciones de copia de seguridad y restauración no predeterminadas.
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 | vswriter.h (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |