Compartilhar via

Método IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile (vsbackup.h)

  • Artigo

Obtém informações sobre conjuntos de arquivos que foram explicitamente excluídos de uma determinada cópia de sombra.

Sintaxe

HRESULT GetExcludeFromSnapshotFile(
  [in]  UINT           iFile,
  [out] IVssWMFiledesc **ppFiledesc
);

Parâmetros

[in] iFile

Um índice para um conjunto de arquivos excluído. O valor desse parâmetro é um inteiro de 0 a n–1 inclusive, em que n é o número total de conjuntos de arquivos explicitamente excluídos de uma determinada cópia de sombra. O valor de n é retornado pelo método IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount .

[out] ppFiledesc

Um ponteiro duplamente indireto para um objeto IVssWMFiledesc que contém as informações do elemento de arquivo.

Retornar valor

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

Valor Significado
S_OK
 O ponteiro para uma interface IVssWMFiledesc foi retornado com êxito.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
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

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

O método GetExcludeFromSnapshotFile destina-se a relatar informações sobre conjuntos de arquivos excluídos de uma cópia de sombra. Os solicitantes não devem excluir arquivos do backup com base nas informações retornadas por esse método.

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 vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot

IVssExamineWriterMetadataEx2

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount