FindFirstFileNameW, fonction (fileapi.h)

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.

[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.

Configuration requise

Voir aussi

Fonctions de gestion des fichiers

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW