Syntaxe
|
DWORD GetCompressedFileSizeA(
LPCTSTR lpFileName,
LPDWORD lpFileSizeHigh
);
|
Paramètres
| Nom |
Description |
| lpFileName |
Ce paramètre permet d'indiquer l'adresse du nom d'un fichier. |
| lpFileSizeHigh |
Ce paramètre permet d'indiquer la partie haute du DWORD correspondant à la taille du fichier compressé. |
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 DWORD de poids faible du nombre réel d'octets d'entreposage sur disque utilisé pour entreposer le fichier spécifié. Si lpFileSizeHigh n'est pas NULL, la fonction place le DWORD de poids fort de cette valeur réelle dans le DWORD pointé par ce paramètre. Il s'agit de la taille du fichier compressé pour les fichiers compressés et de la taille réelle du fichier pour les fichiers non compressés. |
Description
Cette fonction permet de demander le nombre d'octets d'une unité d'entreposage actuellement utilisé pour un fichier spécifié.
Remarques
- Une application peut déterminer si un volume est compressé en appelant GetVolumeInformationA, puis en vérifiant l'état du
drapeau FS_VOL_IS_COMPRESSED dans la valeur DWORD désignée par le paramètre lpFileSystemFlags de cette fonction.
- Si le fichier ne se trouve pas sur un volume prenant en charge la compression ou les fichiers fragmentés, ou si le fichier n'est pas compressé ou un fichier fragmenté, la
valeur obtenue correspond à la taille réelle du fichier, identique à la valeur renvoyée par un appel à GetFileSize.
- Comportement du lien symbolique : si le chemin pointe vers un lien symbolique, la fonction renvoie la taille de fichier de la cible.
- 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
