Fonction FindFirstStreamW (fileapi.h)

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

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

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

Spécifications

Voir aussi

Fonctions de gestion des fichiers

FindClose

FindFirstStreamTransactedW

FindNextStreamW

STREAM_INFO_LEVELS

WIN32_FIND_STREAM_DATA