Función FindFirstFileExFromAppW (fileapifromapp.h)

Busca en un directorio un archivo o subdirectorio con un nombre y atributos que coincidan con los especificados. El comportamiento de esta función es idéntico a FindFirstFileEx, salvo que esta función se adhiere al modelo de seguridad de aplicaciones de Plataforma universal de Windows.

Sintaxis

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

Parámetros

lpFileName

Directorio o ruta de acceso, y el nombre de archivo. El nombre de archivo puede incluir caracteres comodín, por ejemplo, un asterisco (*) o un signo de interrogación (?).

Este parámetro no debe ser NULL, una cadena no válida (por ejemplo, una cadena vacía o una cadena que falta el carácter nulo de terminación) o finalizar en una barra diagonal inversa final (\).

Si la cadena termina con un carácter comodín, un punto o un nombre de directorio, el usuario debe tener acceso a la raíz y a todos los subdirectorios de la ruta de acceso.

Para obtener información sobre cómo no participar en la limitación de MAX_PATH sin prepending "\\?\\ ", vea la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.

fInfoLevelId

Nivel de información de los datos devueltos.

Este parámetro es uno de los FINDEX_INFO_LEVELS valores de enumeración.

lpFindFileData

Puntero al búfer que recibe los datos del archivo.

El tipo de puntero viene determinado por el nivel de información especificado en el parámetro fInfoLevelId .

fSearchOp

El tipo de filtrado que se va a realizar es diferente de la coincidencia de caracteres comodín.

Este parámetro es uno de los FINDEX_SEARCH_OPS valores de enumeración.

lpSearchFilter

Puntero a los criterios de búsqueda si el fSearchOp especificado necesita información de búsqueda estructurada.

En este momento, ninguno de los valores de fSearchOp admitidos requiere información de búsqueda extendida. Por lo tanto, este puntero debe ser NULL.

dwAdditionalFlags

Especifica marcas adicionales que controlan la búsqueda.

Valor	Significado
FIND_FIRST_EX_CASE_SENSITIVE 1	Las búsquedas distinguen mayúsculas de minúsculas.
FIND_FIRST_EX_LARGE_FETCH 2	Usa un búfer mayor para las consultas de directorio, lo que puede aumentar el rendimiento de la operación de búsqueda.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4	Limita los resultados a los archivos que están físicamente en el disco. Esta marca solo es relevante cuando hay un filtro de virtualización de archivos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de búsqueda usado en una llamada posterior a FindNextFile o FindClose, y el parámetro lpFindFileData contiene información sobre el primer archivo o directorio encontrado.

Si se produce un error en la función o no se encuentra los archivos de la cadena de búsqueda en el parámetro lpFileName , el valor devuelto es INVALID_HANDLE_VALUE y el contenido de lpFindFileData es indeterminado. Para obtener información ampliada de los errores, llame a la función GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803
Encabezado	fileapifromapp.h