Compartilhar via


Método IVssHardwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

O método BeginPrepareSnapshot é chamado para cada cópia de sombra adicionada ao conjunto de cópias de sombra.

Nota Os provedores de hardware só têm suporte em sistemas operacionais Windows Server.
 

Sintaxe

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

Parâmetros

[in] SnapshotSetId

Identificador do conjunto de cópias de sombra.

[in] SnapshotId

Identificador da cópia de sombra a ser criada.

[in] lContext

Contexto de cópia de sombra para a cópia de sombra atual definida como enumerada por _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Contagem de LUNs que contribuem para esse volume de cópia de sombra.

[in] rgDeviceNames

Ponteiro para a matriz de ponteiros lLunCount para cadeias de caracteres, cada cadeia de caracteres que contém o nome de um LUN a ser copiado de sombra.

[in, out] rgLunInformation

Ponteiro para a matriz de estruturas de VDS_LUN_INFORMATIONlLunCount, uma para cada LUN que contribui para esse volume de cópia de sombra.

Retornar valor

Esse método pode retornar um desses valores.

Valor/código retornado 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_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
O provedor atingiu o número máximo de volumes aos quais pode dar suporte.
VSS_E_NESTED_VOLUME_LIMIT
O volume especificado está aninhado muito profundamente para participar da operação vss.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse código de retorno.

VSS_E_PROVIDER_VETO
0x80042306L
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.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
O provedor não dá suporte a esse volume.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
Não há suporte para o contexto especificado por lContext .

Comentários

Esse método não pode ser chamado para um VHD (disco rígido virtual) aninhado dentro de outro VHD.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para VHDs.

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

Confira também

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES