Fonction FindFirstFileExFromAppW (fileapifromapp.h)

Recherche dans un répertoire un fichier ou un sous-répertoire dont le nom et les attributs correspondent à ceux spécifiés. Le comportement de cette fonction est identique à FindFirstFileEx, sauf que cette fonction adhère au modèle de sécurité d’application plateforme Windows universelle.

Syntaxe

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

Paramètres

lpFileName

Répertoire ou chemin d’accès, et nom de fichier. Le nom de fichier peut inclure des caractères génériques, par exemple un astérisque (*) ou un point d’interrogation ( ?).

Ce paramètre ne doit pas être NULL, une chaîne non valide (par exemple, une chaîne vide ou une chaîne qui ne contient pas le caractère null de fin) ou se terminer par une barre oblique inverse de fin (\).

Si la chaîne se termine par un caractère générique, un point ou un nom de répertoire, l’utilisateur doit avoir accès à la racine et à tous les sous-répertoires sur le chemin d’accès.

Pour plus d’informations sur la désactivation de la limitation de MAX_PATH sans passer à la limite « \ ??\ », consultez la section « Limitation de longueur maximale du chemin d’accès » de l’article Nommage des fichiers, des chemins et des espaces de noms .

fInfoLevelId

Niveau d’informations des données retournées.

Ce paramètre est l’une des valeurs d’énumération FINDEX_INFO_LEVELS .

lpFindFileData

Pointeur vers la mémoire tampon qui reçoit les données du fichier.

Le type de pointeur est déterminé par le niveau d’informations spécifié dans le paramètre fInfoLevelId .

fSearchOp

Type de filtrage à effectuer qui est différent de la correspondance de caractères génériques.

Ce paramètre est l’une des valeurs d’énumération FINDEX_SEARCH_OPS .

lpSearchFilter

Pointeur vers les critères de recherche si le fSearchOp spécifié a besoin d’informations de recherche structurées.

À ce stade, aucune des valeurs fSearchOp prises en charge ne nécessite d’informations de recherche étendue. Par conséquent, ce pointeur doit avoir la valeur NULL.

dwAdditionalFlags

Spécifie des indicateurs supplémentaires qui contrôlent la recherche.

Valeur	Signification
FIND_FIRST_EX_CASE_SENSITIVE 1	Les recherches respectent la casse.
FIND_FIRST_EX_LARGE_FETCH 2	Utilise une mémoire tampon plus grande pour les requêtes d’annuaire, ce qui peut augmenter les performances de l’opération de recherche.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4	Limite les résultats aux fichiers physiquement sur disque. Cet indicateur n’est pertinent que lorsqu’un filtre de virtualisation de fichiers est présent.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de recherche utilisé dans un appel suivant à FindNextFile ou FindClose, et le paramètre lpFindFileData contient des informations sur le premier fichier ou répertoire trouvé.

Si la fonction échoue ou ne parvient pas à localiser les fichiers de la chaîne de recherche dans le paramètre lpFileName , la valeur de retour est INVALID_HANDLE_VALUE et le contenu de lpFindFileData est indéterminé. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	fileapifromapp.h