Compartilhar via

Método CVssWriter::GetSnapshotDeviceName (vswriter.h)

  • Artigo

O método GetSnapshotDeviceName retorna o nome do dispositivo que hospeda a cópia de sombra do volume ou compartilhamento de arquivos especificado. Esse método permite que os gravadores deem suporte a cópias de sombra de recuperação automática e só podem ser chamados durante o processamento do método OnPostSnapshot .

Sintaxe

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Parâmetros

[in] wszOriginalVolume

Nome do volume original ou o caminho UNC do compartilhamento de arquivo original que contém dados usados para o conjunto de cópias de sombra atual. O nome do volume deve estar em um dos seguintes formatos e deve incluir uma barra invertida à direita (\):

  • O caminho de uma pasta montada, por exemplo, Y:\MountX\
  • Uma letra da unidade, por exemplo, D:\
  • Um caminho GUID de volume do formulário \\?\Volume{GUID}\ (em que o GUID identifica o volume)
  • Um caminho UNC que especifica um compartilhamento de arquivos remoto, por exemplo, \\Clusterx\Share1\

[out] ppwszSnapshotDevice

O endereço de um LPCWSTR que receberá um ponteiro para o nome do dispositivo da cópia de sombra.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 Retornou com êxito o nome do volume de cópia de sombra.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
VSS_E_BAD_STATE
 A chamada não foi feita durante o evento PostSnapshot.
VSS_E_OBJECT_NOT_FOUND
 O parâmetro wszOriginalVolume não é um dos volumes ou compartilhamentos de arquivos no conjunto de cópias de sombra.

Comentários

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Não há suporte para compartilhamentos de arquivos remotos até Windows 8 e Windows Server 2012.

Para obter o nome do volume original para o parâmetro wszOriginalVolume , primeiro chame o método CVssWriter::GetCurrentVolumeCount para consultar o número de volumes no conjunto de cópias de sombra. Em seguida, chame o método CVssWriter::GetCurrentVolumeArray para enumerar os nomes originais dos volumes no conjunto de cópias de sombra.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib