GetDiskFreeSpaceA, fonction (fileapi.h)
Récupère des informations sur le disque spécifié, y compris la quantité d’espace libre sur le disque.
Syntaxe
BOOL GetDiskFreeSpaceA(
[in] LPCSTR lpRootPathName,
[out] LPDWORD lpSectorsPerCluster,
[out] LPDWORD lpBytesPerSector,
[out] LPDWORD lpNumberOfFreeClusters,
[out] LPDWORD lpTotalNumberOfClusters
);
Paramètres
[in] lpRootPathName
Répertoire racine du disque pour lequel les informations doivent être retournées. Si ce paramètre a la valeur NULL, la fonction utilise la racine du disque actuel. Si ce paramètre est un nom UNC, il doit inclure une barre oblique inverse de fin (par exemple, « \\MyServer\MyShare\ »). En outre, une spécification de lecteur doit avoir une barre oblique inverse de fin (par exemple, « C :\ »). L’application appelante doit disposer de droits d’accès FILE_LIST_DIRECTORY pour ce répertoire.
[out] lpSectorsPerCluster
Pointeur vers une variable qui reçoit le nombre de secteurs par cluster.
[out] lpBytesPerSector
Pointeur vers une variable qui reçoit le nombre d’octets par secteur.
[out] lpNumberOfFreeClusters
Pointeur vers une variable qui reçoit le nombre total de clusters gratuits sur le disque disponibles pour l’utilisateur associé au thread appelant.
Si des quotas de disque par utilisateur sont en cours d’utilisation, cette valeur peut être inférieure au nombre total de clusters libres sur le disque.
[out] lpTotalNumberOfClusters
Pointeur vers une variable qui reçoit le nombre total de clusters sur le disque disponibles pour l’utilisateur associé au thread appelant.
Si des quotas de disque par utilisateur sont en cours d’utilisation, cette valeur peut être inférieure au nombre total de clusters sur le disque.
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.
Remarques
La fonction GetDiskFreeSpaceEx vous permet d’éviter une partie de l’arithmétique requise par la fonction GetDiskFreeSpace .
Comportement de lien symbolique : si le chemin pointe vers un lien symbolique, l’opération est effectuée sur la cible.
Notes
L’en-tête fileapi.h définit GetDiskFreeSpace en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |