Método IVssHardwareSnapshotProviderEx::OnLunStateChange (vsprov.h)

Artigo
07/16/2024

O serviço VSS chama esse método para notificar os provedores de hardware de uma alteração de estado LUN.

Observação Provedores de hardware só têm suporte em sistemas operacionais Windows Server.

Sintaxe

HRESULT OnLunStateChange(
  [in] VDS_LUN_INFORMATION *pSnapshotLuns,
  [in] VDS_LUN_INFORMATION *pOriginalLuns,
  [in] DWORD               dwCount,
  [in] DWORD               dwFlags
);

Parâmetros

[in] pSnapshotLuns

Um ponteiro para uma matriz de estruturas dwCountVDS_LUN_INFORMATION, uma para cada LUN que contribui para o volume de cópia de sombra.

[in] pOriginalLuns

Um ponteiro para uma matriz de estruturas dwCountVDS_LUN_INFORMATION, uma para cada LUN que contribui para o volume original.

[in] dwCount

Número de elementos na matriz de pSnapshotLuns . Esse também é o número de elementos na matriz pOriginalLuns .

[in] dwFlags

Uma máscara de bits de sinalizadores _VSS_HARDWARE_OPTIONS que fornecem informações sobre a alteração de estado pela qual os LUNs de cópia de sombra foram submetidos. A tabela a seguir descreve como cada sinalizador é usado nesse parâmetro.

Valor	Significado
VSS_ONLUNSTATECHANGE_NOTIFY_READ_WRITE 0x00000100	O LUN de cópia de sombra será convertido permanentemente em leitura-gravação.
VSS_ONLUNSTATECHANGE_NOTIFY_LUN_PRE_RECOVERY 0x00000200	Os LUNs de cópia de sombra serão convertidos temporariamente em leitura/gravação e estão prestes a passar por recuperação TxF ou recuperação automática do VSS.
VSS_ONLUNSTATECHANGE_NOTIFY_LUN_POST_RECOVERY 0x00000400	Os LUNs de cópia de sombra acabaram de passar pela recuperação TxF ou recuperação automática do VSS e foram convertidos novamente em somente leitura.
VSS_ONLUNSTATECHANGE_DO_MASK_LUNS 0x00000800	Os LUNs de cópia de sombra devem ser mascarados do computador atual, mas não excluídos.

Valor de retorno

Esse método pode retornar um desses valores.

Código/valor de retorno	Descrição
S_OK 0x00000000L	A operação foi concluída com êxito.
E_OUTOFMEMORY 0x8007000EL	Memória insuficiente ou outros recursos do sistema.
E_INVALIDARG 0x80070057L	Um dos valores de parâmetro não é válido.
VSS_E_PROVIDER_VETO 0x80042306L	Ocorreu um erro inesperado do provedor. Se isso for retornado, o erro deverá ser descrito em uma entrada no log de eventos do aplicativo, dando ao usuário informações sobre como resolver o problema.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Nenhum com suporte
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	vsprov.h

Consulte também

IVssHardwareSnapshotProviderEx

Compartilhar via