Método IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)
O método LocateLuns solicita que o provedor de hardware torne os LUNs de cópia de sombra visíveis para o computador. O método LocateLuns é chamado pelo VSS quando um conjunto de cópias de sombra de hardware é importado para um computador. O provedor é responsável por qualquer desmascaração (ou "exibição") no nível do hardware.
Sintaxe
HRESULT LocateLuns(
[in] LONG lLunCount,
[in] VDS_LUN_INFORMATION *rgSourceLuns
);
Parâmetros
[in] lLunCount
Número de LUNs que contribuem para esse conjunto de cópias de sombra.
[in] rgSourceLuns
Ponteiro para uma matriz de estruturas de VDS_LUN_INFORMATIONiLunCount, uma para cada LUN que faz parte do conjunto de cópias de sombra a ser importado.
Retornar valor
Esse método pode retornar um desses valores.
| Valor/código retornado | Descrição |
|---|---|
|
A operação foi concluída com êxito. |
|
Memória insuficiente ou outros recursos do sistema. |
|
Um dos valores de parâmetro não é válido. |
|
Ocorreu um erro inesperado do provedor. O provedor deve relatar um evento no log de eventos do aplicativo fornecendo ao usuário informações sobre como resolve o problema. |
Comentários
No parâmetro rgSourceLuns , o VSS fornece a mesma matriz de estruturas VDS_LUN_INFORMATION que o provedor inicializou anteriormente em seu método IVssHardwareSnapshotProvider::GetTargetLuns . Para cada estrutura VDS_LUN_INFORMATION na matriz, o provedor deve desmascarar (ou "superfície") o LUN de cópia de sombra correspondente para o computador.
Imediatamente após o retorno desse método, o VSS executará uma nova verificação e enumeração para detectar os dispositivos que chegaram. Isso faz com que todos os LUNs expostos sejam descobertos pelo gerenciador PnP. Em paralelo com a escuta de chegadas de disco, o VSS também escutará as chegadas ocultas do volume. O VSS deixará de escutar depois que todos os volumes que contribuem para um conjunto de cópias de sombra aparecerem no sistema ou ocorrer um tempo limite. Se alguns dispositivos de disco ou volume não aparecerem nessa janela, o solicitante será informado de que apenas algumas das cópias de sombra foram importadas pelo VSS retornando VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED para o solicitante. O solicitante também receberá o mesmo erro do VSS se as estruturas VDS_LUN_INFORMATION recebidas dos métodos GetTargetLuns e IVssHardwareSnapshotProvider::FillInLunInfo não corresponderem.
Esse método não pode ser usado para mapear LUNs de cópia de sombra como somente leitura.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vsprov.h |