Método IVssHardwareSnapshotProvider::GetTargetLuns (vsprov.h)
O método GetTargetLuns solicita que o provedor de hardware inicialize as estruturas de VDS_LUN_INFORMATION para os LUNs de cópia de sombra recém-criados. O método GetTargetLuns é chamado após o método IVssProviderCreateSnapshotSet::P ostCommitSnapshots . A identificação de informações para cada LUN recém-criado é retornada ao VSS por meio de estruturas de VDS_LUN_INFORMATION .
Sintaxe
HRESULT GetTargetLuns(
[in] LONG lLunCount,
[in] VSS_PWSZ *rgDeviceNames,
[in] VDS_LUN_INFORMATION *rgSourceLuns,
[in, out] VDS_LUN_INFORMATION *rgDestinationLuns
);
Parâmetros
[in] lLunCount
Contagem de LUNs que contribuem para o volume original.
[in] rgDeviceNames
Ponteiro para uma matriz de ponteiros lLunCount para cadeias de caracteres. Cada cadeia de caracteres contém o nome de um LUN original a ser copiado por sombra.
[in] rgSourceLuns
Ponteiro para uma matriz de estruturas de VDS_LUN_INFORMATIONlLunCount, uma para cada LUN que contribui para o volume original.
[in, out] rgDestinationLuns
Ponteiro para uma matriz de estruturas de VDS_LUN_INFORMATIONlLunCount, uma para cada novo LUN de cópia de sombra criado durante o processamento de cópia de sombra. Deve haver uma correspondência um-para-um entre os elementos das matrizes rgSourceLuns e rgDestinationLuns .
Valor retornado
Esse método pode retornar um desses valores.
| Valor/código retornado | Descrição |
|---|---|
|
A operação foi concluída com êxito. |
|
Sem memória 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 rgDestinationLuns , o VSS fornece uma estrutura de VDS_LUN_INFORMATION vazia para cada LUN de cópia de sombra recém-criada. Os LUNs de cópia de sombra não são exibidos ou visíveis para o sistema. O provedor deve inicializar os membros da estrutura de VDS_LUN_INFORMATION com os dados de consulta scsi apropriados e as informações de dados vitais do produto 80 (número de série do dispositivo) e a página 83 (identidade do dispositivo). A estrutura deve conter valores de membro corretos, de modo que os LUNs de cópia de sombra possam ser localizados pelo Windows do computador original ou de qualquer outro computador conectado à SAN.
Os membros da estrutura VDS_LUN_INFORMATION correspondem às informações da página 80, com as seguintes exceções:
- O membro m_version deve ser definido como VER_VDS_LUN_INFORMATION.
- O membro m_BusType é ignorado em comparações durante a importação. Esse valor depende da pilha de armazenamento PnP no dispositivo de disco correspondente. Normalmente, isso é VDSBusTypeScsi.
- O membro m_diskSignature é ignorado em comparações durante a importação. O provedor deve definir esse membro como GUID_NULL.
As estruturas VDS_LUN_INFORMATION retornadas aqui devem ser iguais às estruturas fornecidas no método IVssHardwareSnapshotProvider::FillInLunInfo durante a importação para que o VSS possa usar essas informações para identificar os LUNs de cópia de sombra recém-chegados na importação. Essas mesmas estruturas serão passadas para o provedor no método IVssHardwareSnapshotProvider::LocateLuns .
Requisitos
| 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 |