Método IVssComponent::GetAlternateLocationMappingCount (vswriter.h)
O método GetAlternateLocationMappingCount retorna o número de mapeamentos de localização alternativos usados por um solicitante na restauração de dados. Um gravador ou um solicitante pode chamar esse método.
Sintaxe
HRESULT GetAlternateLocationMappingCount(
[out] UINT *pcMappings
);
Parâmetros
[out] pcMappings
O endereço de uma variável alocada pelo chamador que recebe o número de mapeamentos de localização alternativos.
Valor retornado
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
Retornou com êxito o valor do atributo. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
Comentários
A contagem de mapeamentos de localização alternativos retornados por GetAlternateLocationMappingCount pode ser devido não apenas a arquivos no componente atual, mas a arquivos em qualquer um de seus subcomponentes não reelecionáveis.
Um mapeamento de local alternativo é usado somente durante uma operação de restauração e não deve ser confundido com um caminho alternativo, que é usado somente durante uma operação de backup.
A contagem retornada por GetAlternateLocationMappingCount refere-se ao número de mapeamentos de localização alternativos usados no curso da restauração de arquivos.
A contagem é atualizada por chamadas para IVssBackupComponents::AddAlternativeLocationMapping.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |