WdDeleteSearchOptions

Especifica los patrones de filtro de archivos y directorios para una operación de eliminación. Introducido en: RIT 0.0.13-preview.

Sintaxis

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

Miembros

includeFilePattern
Tipo: const char* Incluye los archivos que coinciden con los nombres especificados. Se admiten los caracteres comodín * y ?, y una lista de patrones se puede separar con punto y coma (;). El valor predeterminado es nullptr, que incluye todo. excludeFilePattern
Tipo: const char* Excluye los archivos que coinciden con los nombres especificados. Se admiten los caracteres comodín * y ?, y una lista de patrones se puede separar con punto y coma (;). El valor predeterminado es nullptr, que no excluye ningún archivo. excludeDirPattern
Tipo: const char* Excluye los directorios que coinciden con los nombres especificados, no con rutas de acceso. Se admiten los caracteres comodín * y ?. El valor predeterminado es nullptr, que no excluye ningún directorio de la eliminación. includeFileAttributes
Tipo: uint64_t Incluye los archivos que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM y FILE_ATTRIBUTE_HIDDEN. El valor predeterminado es 0, que incluye todos los atributos. Para obtener más información sobre los atributos de archivo, consulte Constantes de atributos de archivo. excludeFileAttributes
Tipo: uint64_t Excluye los archivos que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM y FILE_ATTRIBUTE_HIDDEN. El valor predeterminado es 0, que no excluye ningún atributo. Para obtener más información sobre los atributos de archivo, consulte Constantes de atributos de archivo. includeDirAttributes
Tipo: uint64_t Incluye los directorios que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM y FILE_ATTRIBUTE_HIDDEN. El valor predeterminado es 0, que incluye todos los atributos. excludeDirAttributes
Tipo: uint64_t Excluye los directorios que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_SYSTEM y FILE_ATTRIBUTE_HIDDEN. El valor predeterminado es 0, que no excluye ningún atributo.

Ejemplos

Eliminar solo archivos .pdb y .log:

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

Eliminar todo excepto un directorio de datos guardados:

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

Eliminar los archivos archivados, pero conservar los archivos de solo lectura y los directorios ocultos:

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

[!NOTE]
Cuando hay un conflicto entre los patrones de inclusión y exclusión, el patrón de exclusión tiene prioridad y el elemento no se elimina.

Comentarios

Pase esta estructura a WdDeleteRemoteFiles mediante el parámetro searchOptions para filtrar qué archivos y directorios se seleccionan para eliminarlos. Si se pasa nullptr para searchOptions, se incluyen todos los elementos sin filtrar. Estas opciones solo se aplican cuando remoteFolderPath se resuelve en una carpeta. Se omiten cuando remoteFolderPath se resuelve en un solo archivo. Una eliminación filtrada que deja elementos conserva la carpeta raíz incluso cuando deleteRootFolder está establecido en true en WdDeleteOptions, porque la carpeta solo se quita si queda vacía.

Requisitos

Requisito	Valor
Encabezado	WdRemoteIteration.h
Biblioteca	wdremoteapi.lib
Sistemas operativos compatibles	Windows 11 y versiones posteriores
Arquitecturas compatibles	x64, ARM64

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

WdDeleteSearchOptions

WdDeleteSearchOptions

Sintaxis

Miembros

Ejemplos

Comentarios

Requisitos

Consulte también

​WdDeleteSearchOptions

​Sintaxis

​Miembros

​Ejemplos

​Comentarios

​Requisitos

​Consulte también

WdDeleteSearchOptions

Sintaxis

Miembros

Ejemplos

Comentarios

Requisitos

Consulte también