GetFileSizeEx, fonction (fileapi.h)
Récupère la taille du fichier spécifié.
Syntaxe
BOOL GetFileSizeEx(
[in] HANDLE hFile,
[out] PLARGE_INTEGER lpFileSize
);
Paramètres
[in] hFile
Descripteur du fichier. Le handle doit avoir été créé avec le droit d’accès FILE_READ_ATTRIBUTES ou équivalent, ou l’appelant doit disposer d’une autorisation suffisante sur le répertoire qui contient le fichier. Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.
[out] lpFileSize
Pointeur vers une structure de LARGE_INTEGER qui reçoit la taille du fichier, en octets.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Opérations traitées : S’il existe une transaction liée au handle de fichier, la fonction retourne des informations pour l’affichage de fichiers isolé.
Applications du Windows Store : GetFileSizeEx n’est pas pris en charge. Utilisez GetFileInformationByHandleEx.
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 |
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | fileapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |