Método IVssCreateExpressWriterMetadata::AddExcludeFiles (vswriter.h)
Exclui um conjunto de arquivos (um arquivo ou arquivos especificados) que, de outra forma, pode ser incluído implicitamente quando um componente de um gravador expresso é copiado em backup.
Sintaxe
HRESULT AddExcludeFiles(
[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 sob o qual os arquivos devem ser excluídos.
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 aos aplicativos que recuperam essas informações marcar.
[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 deve 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 |
|---|---|
|
A operação foi bem-sucedida. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 em VSS. |
|
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. |
Comentários
Os gravadores expressos dão suporte apenas a recursos locais— conjuntos de arquivos cujo caminho absoluto começa com uma especificação de volume local válida e não pode ser uma unidade de rede mapeada. Portanto, as entradas de caminho (wszPath) para AddExcludeFiles (após a resolução de qualquer variável de ambiente) devem estar nesse formato. Por exemplo, geralmente é conveniente definir um componente para incluir todos os arquivos em um diretório especificado e, em seguida, usar AddExcludeFiles para remover explicitamente alguns arquivos (por exemplo, arquivos temporários) de um backup.
Para obter mais informações sobre como excluir arquivos, consulte Excluir Especificação da Lista de Arquivos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |