Share via

Método IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot (vswriter.h)

  • Artigo

Relata todos os conjuntos de arquivos que serão explicitamente excluídos pelo gravador quando uma cópia de sombra for criada.

Chamar esse método não faz com que os arquivos sejam excluídos. O gravador é responsável por excluir os arquivos da cópia de sombra em seu método CVssWriter::OnPostSnapshot .

Sintaxe

HRESULT AddExcludeFilesFromSnapshot(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

Parâmetros

[in] wszPath

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o diretório raiz no qual os arquivos devem ser excluídos.

O diretório pode ser um diretório local no computador VSS ou pode ser um diretório de compartilhamento de arquivos em um servidor de arquivos remoto.

Há suporte para caminhos UNC.

O caminho pode conter variáveis de ambiente (por exemplo, %SystemRoot%), mas não pode conter caracteres curinga.

Não há nenhum requisito de que o caminho termine com uma barra invertida (""). Cabe a aplicativos que recuperam essas informações marcar se o caminho termina com uma barra invertida.

[in] wszFilespec

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém a especificação de arquivo dos arquivos a serem excluídos.

Uma especificação de arquivo não pode conter especificações de diretório (por exemplo, sem barras invertidas), mas pode conter o ? e * caracteres curinga.

[in] bRecursive

Um valor booliano que especifica se o caminho especificado pelo parâmetro wszPath identifica apenas um único diretório ou se indica uma hierarquia de diretórios a serem percorridos recursivamente. Esse parâmetro deverá ser definido como true se o caminho for tratado como uma hierarquia de diretórios a serem recursados ou false caso contrário.

Para obter informações sobre como percorrer pastas montadas, consulte Trabalhando com pastas montadas e pontos de nova análise.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
0x00000000L
 A operação foi bem-sucedida.
E_INVALIDARG
0x80070057L
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
0x8007000EL
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.
VSS_E_NOT_SUPPORTED
0x8004232FL
 Não há suporte para esse método para gravadores expressos.
VSS_E_UNEXPECTED
 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 no 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.

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.

O uso do método AddExcludeFilesFromSnapshot é opcional. Os gravadores devem usar esse método apenas para arquivos grandes que mudam significativamente entre operações de cópia de sombra.

Esse método não substitui o método IVssCreateWriterMetadata::AddExcludeFiles . Os gravadores devem continuar a usar o método AddExcludeFiles para relatar quais conjuntos de arquivos são excluídos do backup.

O chamador é responsável por chamar o método IUnknown::Release para liberar os recursos do objeto IVssWMFiledesc retornado.

Requisitos

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

Confira também

IVssCreateWriterMetadata::AddExcludeFiles

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile