Fonction FindFirstStreamW (fileapi.h)

Article
08/23/2023

Énumère le premier flux avec un type de flux ::$DATA dans le fichier ou le répertoire spécifié.

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

Syntaxe

HANDLE FindFirstStreamW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags
);

Paramètres

[in] lpFileName

Nom de fichier complet.

[in] InfoLevel

Niveau d’informations des données retournées. Ce paramètre est l’une des valeurs du type d’énumération STREAM_INFO_LEVELS .

Valeur	Signification
FindStreamInfoStandard 0	Les données sont retournées dans une structure WIN32_FIND_STREAM_DATA .

[out] lpFindStreamData

Pointeur vers une mémoire tampon qui reçoit les données de flux de fichiers. Le format de ces données dépend de la valeur du paramètre InfoLevel .

dwFlags

Réservé pour un usage futur. Ce paramètre doit être égal à zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de recherche qui peut être utilisé dans les appels suivants à la fonction FindNextStreamW .

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

Si aucun flux n’est trouvé, la fonction échoue et GetLastError retourne ERROR_HANDLE_EOF (38).

Si le système de fichiers ne prend pas en charge les flux, la fonction échoue et GetLastError retourne ERROR_INVALID_PARAMETER (87).

Notes

La fonction FindFirstStreamW ouvre un handle de recherche et retourne des informations sur le premier flux $DATA dans le fichier ou le répertoire spécifié. Pour les fichiers, il s’agit toujours du flux de données sans nom par défaut, « ::$DATA ». Les répertoires n’ont pas de flux $DATA par défaut et ne peuvent pas avoir de flux de données sans nom, mais peuvent avoir des flux de données nommés définis après leur création. Une fois le handle de recherche établi, utilisez-le dans les appels à la fonction FindNextStreamW pour rechercher d’autres flux dans le fichier ou répertoire spécifié. Lorsque le handle de recherche n’est plus nécessaire, il doit être fermé à l’aide de la fonction FindClose .

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)	Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Oui
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

SMB 3.0 prend en charge la liste des flux inférieur ou égal à 64 Ko.

Spécifications


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