Método IVssBackupComponents::AddToSnapshotSet (vsbackup.h)
O método AddToSnapshotSet adiciona um volume original ou compartilhamento de arquivo remoto original ao conjunto de cópias de sombra.
Sintaxe
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Parâmetros
[in] pwszVolumeName
Cadeia de caracteres largos terminada em nulo que contém o nome do volume ou o caminho UNC do compartilhamento de arquivos remoto a ser copiado por sombra. O nome ou caminho UNC 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 de 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\
[in] ProviderId
O provedor a ser usado. GUID_NULL pode ser usado, nesse caso, o provedor padrão será usado.
[out] pidSnapshot
Identificador retornado da cópia de sombra adicionada.
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
Adicionado com êxito o volume ou o compartilhamento de arquivos remotos ao conjunto de cópias de sombra. |
|
O chamador não tem privilégios de backup suficientes ou não é um administrador. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta. |
|
O número máximo de volumes ou compartilhamentos de arquivos remotos foi adicionado ao conjunto de cópias de sombra. O volume especificado ou o compartilhamento de arquivos remoto não foi adicionado ao conjunto de cópias de sombra. |
|
O volume ou o compartilhamento de arquivos remoto foi adicionado ao número máximo de conjuntos de cópias de sombra. O volume especificado ou o compartilhamento de arquivos remoto não foi adicionado ao conjunto de cópias de sombra. |
|
O volume especificado está aninhado muito profundamente para participar da operação vss. Os possíveis motivos para esse erro incluem o seguinte:
|
|
pwszVolumeName não corresponde a um volume ou compartilhamento de arquivos remoto existente. |
|
ProviderId não corresponde a um provedor registrado. |
|
Erro esperado do provedor. O provedor registrou o erro no log de eventos. Para obter mais informações, consulte Tratamento de eventos e erros em VSS. |
|
Outra criação de cópia de sombra já está em andamento. Ocorre ao adicionar um volume CSV a um conjunto de instantâneo de vários nós ao mesmo tempo ou ao adicionar um compartilhamento de expansão ao instantâneo definido de vários nós de cliente SMB ao mesmo tempo. |
|
O valor do parâmetro ProviderId é GUID_NULL e nenhum provedor VSS indica que ele dá suporte ao volume especificado ou ao compartilhamento de arquivos remoto. |
|
O volume ou o compartilhamento de arquivos remoto não tem suporte do provedor especificado. |
|
Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado. |
|
O provedor retornou um código de erro inesperado. Esse código de erro só é retornado por meio do método QueryStatus na interface IVssAsync retornada no parâmetro ppAsync . |
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.
Se pwszVolumeName for um caminho de compartilhamento UNC, a parte do nome do servidor deverá estar no nome do host ou no formato de nome de domínio totalmente qualificado. Os nomes de compartilhamento UNC com endereços IP devem ser normalizados chamando o método IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths antes de serem passados para AddToSnapshotSet.
O número máximo de volumes copiados de sombra em um conjunto de cópias de sombra é 64.
Se ProviderId for GUID_NULL, o provedor padrão será selecionado de acordo com o seguinte algoritmo:
- Se qualquer provedor de hardware der suporte ao volume ou compartilhamento de arquivos remoto especificado, esse provedor será selecionado.
- Se não houver nenhum provedor de hardware disponível, se algum provedor de software der suporte ao volume especificado, ele será selecionado.
- Se não houver nenhum provedor de hardware ou provedor de software disponível, o provedor do sistema será selecionado. (Há apenas um provedor de sistema pré-instalado, que deve dar suporte a todos os volumes locais não solicitados.)
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para VHDs.
O identificador de cópia de sombra retornado no parâmetro pidSnapshot é armazenado no Documento de Componentes de Backup. No entanto, não há nenhum método para consultar essas informações e talvez o chamador precise armazená-la para que elas possam ser usadas durante a restauração.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |