Partager via


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

Voir aussi

Fonctions de gestion des disques

GetDiskFreeSpaceEx

GetDriveType