Syntaxe
|
DWORD GetFileSize(
HANDLE hFile,
LPDWORD lpFileSizeHigh
);
|
Paramètres
| Nom |
Description |
| hFile |
Ce paramètre permet d'indiquer l'identificateur de descripteur Handle. |
| lpFileSizeHigh |
Ce paramètre permet d'indiquer un pointeur sur la variable où le mot double de poids fort de la taille du fichier est renvoyé. Ce paramètre peut être NULL si l'application ne nécessite pas le mot double de poids fort. |
Retour
| Valeur |
Description |
| INVALID_FILE_SIZE |
Cette valeur permet d'indiquer que la fonction a échoué et le paramètre lpFileSizeHigh est une valeur NULL. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError. |
| INVALID_FILE_SIZE != |
Ces valeurs permettent d'indiquer que l'opération a réussi, et la valeur de retour est le mot double de la taille du fichier, et si lpFileSizeHigh n'est pas NULL, la fonction insère le mot double de la taille supérieure du fichier dans la variable pointée par ce paramètre. |
Description
Cette fonction permet de demander la taille, en octets, d'un fichier spécifié.
Remarques
- Vous ne pouvez pas utiliser la fonction GetFileSize avec l'identificateur de descripteur d'un périphérique non-chercheur tel qu'un canal ou un périphérique de communication.
Pour déterminer le type de fichier pour hFile, utilisez la fonction GetFileType.
- La fonction GetFileSize est destiné récupère la taille non compressée d'un fichier tandis que la fonction GetCompressedFileSizeA est destiné à demander la taille compressée d'un fichier.
- Notez que si la valeur de retour est INVALID_FILE_SIZE (0xffffffff), une application doit appeler la fonction
GetLastError pour déterminer si la fonction a réussi ou échoué. La raison pour laquelle la fonction peut sembler échouer alors que ce n'est pas le cas,
c'est que lpFileSizeHigh pourrait ne pas être NULL ou que la taille du fichier pourrait être 0xffffffff. Dans ce cas, GetLastError
renverra NO_ERROR (0) en cas de succès. En raison de ce comportement, il est recommandé d'utiliser GetFileSizeEx à la place.
- Opérations effectuées : Si une transaction est liée au descripteur de fichier, la fonction renvoie des informations pour la vue de fichier isolé.
- A partir de Windows 8 et Windows Server 2012, cette fonction est prise en charge par
les technologies suivantes :
| Technologie |
Supporté |
| Protocole SMB (Server Message Block) version 3.0 |
Oui |
| TFO (SMB 3.0 Transparent Failover) |
Selon certaines conditions |
| SMB 3.0 avec SO (Scale-out File Share) |
Selon certaines conditions |
| CsvFS (Cluster Shared Volume File System) |
Oui |
| ReFS (Resilient File System) |
Oui |
Dernière mise à jour : Dimanche, le 6 décembre 2015
