WdDeleteSearchOptions

Especifica padrões de filtro de arquivos e diretórios para uma operação de exclusão. Introduzida em: RIT 0.0.13-preview.

Sintaxe

struct WdDeleteSearchOptions
{
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint64_t includeFileAttributes;
    uint64_t excludeFileAttributes;
    uint64_t includeDirAttributes;
    uint64_t excludeDirAttributes;
};

Membros

includeFilePattern
Tipo: const char* Inclui arquivos que correspondem aos nomes especificados. Os caracteres curinga * e ? são compatíveis, e uma lista de padrões pode ser separada por ponto e vírgula (;). O padrão é nullptr, que inclui tudo. excludeFilePattern
Tipo: const char* Exclui arquivos que correspondem aos nomes especificados. Os caracteres curinga * e ? são compatíveis, e uma lista de padrões pode ser separada por ponto e vírgula (;). O padrão é nullptr, que não exclui nenhum arquivo. excludeDirPattern
Tipo: const char* Exclui diretórios que correspondem aos nomes especificados, não aos caminhos. Os caracteres curinga * e ? são compatíveis. O padrão é nullptr, que não impede a exclusão de nenhum diretório. includeFileAttributes
Tipo: uint64_t Inclui arquivos que tenham qualquer um dos atributos de arquivo especificados definido. Os valores compatíveis são FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM e FILE_ATTRIBUTE_HIDDEN. O padrão é 0, que inclui todos os atributos. Para obter informações adicionais sobre atributos de arquivo, confira Constantes de atributos de arquivo. excludeFileAttributes
Tipo: uint64_t Exclui arquivos que tenham qualquer um dos atributos de arquivo especificados definido. Os valores compatíveis são FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM e FILE_ATTRIBUTE_HIDDEN. O padrão é 0, que não exclui nenhum atributo. Para obter informações adicionais sobre atributos de arquivo, confira Constantes de atributos de arquivo. includeDirAttributes
Tipo: uint64_t Inclui diretórios que tenham qualquer um dos atributos de arquivo especificados definido. Os valores compatíveis são FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM e FILE_ATTRIBUTE_HIDDEN. O padrão é 0, que inclui todos os atributos. excludeDirAttributes
Tipo: uint64_t Exclui diretórios que tenham qualquer um dos atributos de arquivo especificados definido. Os valores compatíveis são FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM e FILE_ATTRIBUTE_HIDDEN. O padrão é 0, que não exclui nenhum atributo.

Exemplos

Excluir somente arquivos .pdb e .log:

WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = "*.pdb;*.log",
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirAttributes = 0,
    .excludeDirAttributes = 0
};

Excluir tudo, exceto um diretório de dados salvos:

WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = "SaveData",
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirAttributes = 0,
    .excludeDirAttributes = 0
};

Excluir arquivos arquivados, mas preservar arquivos somente leitura e diretórios ocultos:

WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = FILE_ATTRIBUTE_ARCHIVE,
    .excludeFileAttributes = FILE_ATTRIBUTE_READONLY,
    .includeDirAttributes = 0,
    .excludeDirAttributes = FILE_ATTRIBUTE_HIDDEN
};

[!NOTE]
Quando houver um conflito entre os padrões de inclusão e exclusão, o padrão de exclusão terá precedência e o item não será excluído.

Comentários

Passe esta estrutura para WdDeleteRemoteFiles por meio do parâmetro searchOptions para filtrar quais arquivos e diretórios são selecionados para exclusão. Se nullptr for passado para searchOptions, todos os itens serão incluídos sem filtragem. Essas opções se aplicam somente quando remoteFolderPath é resolvido para uma pasta. Elas são ignoradas quando remoteFolderPath é resolvido para um único arquivo. Uma exclusão filtrada que deixa itens para trás preserva a pasta raiz mesmo quando deleteRootFolder está definido como true em WdDeleteOptions, porque a pasta só é removida se ficar vazia.

Requisitos

Requisito	Valor
Cabeçalho	WdRemoteIteration.h
Biblioteca	wdremoteapi.lib
SO com suporte	Windows 11 e posterior
Arquiteturas com suporte	x64, ARM64

Porting

Build Paths

WdDeleteSearchOptions

WdDeleteSearchOptions

Sintaxe

Membros

Exemplos

Comentários

Requisitos

Confira também

​WdDeleteSearchOptions

​Sintaxe

​Membros

​Exemplos

​Comentários

​Requisitos

​Confira também

WdDeleteSearchOptions

Sintaxe

Membros

Exemplos

Comentários

Requisitos

Confira também