Método IVssComponent::GetAlternateLocationMappingCount (vswriter.h)
El método GetAlternateLocationMappingCount devuelve el número de asignaciones de ubicación alternativas usadas por un solicitante en la restauración de datos. Un escritor o un solicitante pueden llamar a este método.
Sintaxis
HRESULT GetAlternateLocationMappingCount(
[out] UINT *pcMappings
);
Parámetros
[out] pcMappings
Dirección de una variable asignada por el autor de la llamada que recibe el número de asignaciones de ubicación alternativas.
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. |
Comentarios
El recuento de asignaciones de ubicación alternativas devueltas por GetAlternateLocationMappingCount puede deberse no solo a archivos del componente actual, sino a archivos de cualquiera de sus subcomponentes no seleccionables.
Una asignación de ubicación alternativa solo se usa durante una operación de restauración y no debe confundirse con una ruta de acceso alternativa, que solo se usa durante una operación de copia de seguridad.
El recuento devuelto por GetAlternateLocationMappingCount hace referencia al número de asignaciones de ubicación alternativas usadas en el transcurso de la restauración de archivos.
El recuento se actualiza mediante llamadas a IVssBackupComponents::AddAlternativeLocationMapping.
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 (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |