FindFirstFileNameW, fonction (fileapi.h)

Article
02/26/2024

Crée une énumération de tous les liens en dur vers le fichier spécifié. La fonction FindFirstFileNameW retourne un gestionnaire à l’énumération qui peut être utilisé lors des appels suivants à la fonction FindNextFileNameW.

Pour effectuer cette opération en tant qu’opération transactionnelle, utilisez la fonction FindFirstFileNameTransactedW .

Syntaxe

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Paramètres

[in] lpFileName

Nom du fichier.

Pointe À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation de MAX_PATH sans précédencer « \ ?\ ». Pour plus d’informations, consultez la section « Limitation de longueur maximale du chemin d’accès » dans Naming Files, Paths et Namespaces .

[in] dwFlags

Réservés au; spécifiez zéro (0).

[in, out] StringLength

Taille de la mémoire tampon vers laquelle pointe le paramètre LinkName , en caractères. Si cet appel échoue et que l’erreur retournée par la fonction GetLastError est ERROR_MORE_DATA (234), la valeur retournée par ce paramètre est la taille que la mémoire tampon pointée par LinkName doit contenir toutes les données.

[in, out] LinkName

Pointeur vers une mémoire tampon pour stocker le premier nom de lien trouvé pour lpFileName.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de recherche qui peut être utilisé avec la fonction FindNextFileNameW ou fermé avec la fonction FindClose .

Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE (0xffffffff). Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Remarques

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	No
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h, WinBase.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de gestion des fichiers

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW

Partager via