Langage de programmation - C pour Windows - API de Windows

GetVolumeInformationA	kernel32.dll	Demande d'information sur le volume

Syntaxe

BOOL GetVolumeInformationA( LPCTSTR lpRootPathName, LPTSTR lpVolumeNameBuffer, DWORD nVolumeNameSize, LPDWORD lpVolumeSerialNumber, LPDWORD lpMaximumComponentLength, LPDWORD lpFileSystemFlags, LPTSTR lpFileSystemNameBuffer, DWORD nFileSystemNameSize );

Paramètres

Nom	Description
lpRootPathName	Ce paramètre permet d'indiquer un pointeur sur une chaîne de caractères contenant le répertoire racine du volume à décrire. Si ce paramètre est NULL, la racine du répertoire en cours est utilisée. Un barre oblique inversé de fin est requis. Par exemple, vous spécifiez «\MonServeur\MonPartage» comme «\MonServeur\MonPartage» ou l'unité C comme «C:».
lpVolumeNameBuffer	Ce paramètre permet d'indiquer un pointeur sur une mémoire tampon recevant le nom d'un volume spécifié. La taille de la mémoire tampon est spécifiée par le paramètre nVolumeNameSize.
nVolumeNameSize	Ce paramètre permet d'indiquer la longueur du tampon de nom de volume, en TCHAR. La taille maximale de la mémoire tampon est MAX_PATH+1. Ce paramètre est ignoré si le tampon de nom de volume n'est pas fourni.
lpVolumeSerialNumber	Ce paramètre permet d'indiquer un pointeur sur une variable recevant le numéro de série du volume.
lpVolumeSerialNumber	Ce paramètre permet d'indiquer un pointeur sur une variable recevant le numéro de série du volume. Ce paramètre peut être NULL si le numéro de série n'est pas requis. Cette fonction renvoie le numéro de série du volume que le système d'exploitation attribue lorsqu'un l'unité de disque est formaté. Pour obtenir par programme le numéro de série du disque attribué par le fabricant, utilisez la propriété SerialNumber de Win32_PhysicalMedia du WMI (Windows Management Instrumentation).
lpMaximumComponentLength	Ce paramètre permet d'indiquer un pointeur sur une variable recevant la longueur maximale, en TCHAR, d'une composante de nom de fichier pris en charge par un système de fichiers spécifié. Une composante de nom de fichier est la partie d'un nom de fichier entre deux barres obliques inversés.
lpMaximumComponentLength	Ce paramètre permet d'indiquer un pointeur sur une variable recevant la longueur maximale, en TCHAR, d'une composante de nom de fichier pris en charge par un système de fichiers spécifié. Une composante de nom de fichier est la partie d'un nom de fichier entre deux barres obliques inversés. La valeur entreposée dans la variable vers laquelle pointe «* lpMaximumComponentLength» est utilisée pour indiquer qu'un système de fichiers spécifié prend en charge les noms longs. Par exemple, pour un système de fichiers FAT prenant en charge les noms longs, la fonction entrepose la valeur 255, plutôt que le précédent indicateur 8.3. Les noms longs peuvent également être pris en charge sur les systèmes utilisant le système de fichiers NTFS.
lpFileSystemFlags	Ce paramètre permet d'indiquer un pointeur sur une variable recevant des indicateurs associés au système de fichiers spécifié. Ce paramètre peut être un ou plusieurs des indicateurs suivants. Cependant, FILE_FILE_COMPRESSION et FILE_VOL_IS_COMPRESSED s'excluent mutuellement.
	Constante	Valeur	Description
	FILE_CASE_PRESERVED_NAMES	0x00000002	Cette constante permet d'indiquer la prise en charge de la casse conservée des noms de fichier lorsqu'il place un nom sur le disque.
	FILE_CASE_SENSITIVE_SEARCH	0x00000001	Cette constante permet d'indiquer que le volume spécifié prend en charge les noms de fichier sensibles à la casse.
	FILE_DAX_VOLUME	0x20000000	Cette constante permet d'indiquer que le volume spécifié est un volume à accès direct (DAX). Cet drapeau a été introduit dans Windows 10, version 1607.
	FILE_FILE_COMPRESSION	0x00000010	Cette constante permet d'indiquer que le volume spécifié prend en charge la compression basée sur fichier.
	FILE_NAMED_STREAMS	0x00040000	Cette constante permet d'indiquer que le volume spécifié prend en charge les flux nommés.
	FILE_PERSISTENT_ACLS	0x00000008	Cette constante permet d'indiquer que le volume spécifié conserve et applique les listes de contrôle d'accès (ACL). Par exemple, le système de fichiers NTFS préserve et applique les listes de contrôle d'accès, contrairement au système de fichiers FAT.
	FILE_READ_ONLY_VOLUME	0x00080000	Cette constante permet d'indiquer que le volume spécifié est en lecture seule.
	FILE_SEQUENTIAL_WRITE_ONCE	0x00100000	Cette constante permet d'indiquer que le volume spécifié prend en charge une seule écriture séquentielle.
	FILE_SUPPORTS_ENCRYPTION	0x00020000	Cette constante permet d'indiquer que le volume spécifié prend en charge le système de fichiers crypté (EFS).
	FILE_SUPPORTS_EXTENDED_ATTRIBUTES	0x00800000	Cette constante permet d'indiquer que le volume spécifié prend en charge les attributs étendus. Un attribut étendu est une méta-donnée spécifique à une application qu'une application peut associer à un fichier et ne fait pas partie des données du fichier. C'est constante n'est pas prise en charge par Windows XP et Windows Vista.
	FILE_SUPPORTS_HARD_LINKS	0x00400000	Cette constante permet d'indiquer que le volume spécifié prend en charge les liens physiques. C'est constante n'est pas prise en charge par Windows XP et Windows Vista.
	FILE_SUPPORTS_OBJECT_IDS	0x00010000	Cette constante permet d'indiquer que le volume spécifié prend en charge les identificateurs d'objet.
	FILE_SUPPORTS_OPEN_BY_FILE_ID	0x01000000	Cette constante permet d'indiquer que le système de fichiers prend en charge l'ouverture par FileID. C'est constante n'est pas prise en charge par Windows XP et Windows Vista.
	FILE_SUPPORTS_REPARSE_POINTS	0x00000080	Cette constante permet d'indiquer que le volume spécifié prend en charge les points d'analyse. Le ReFS prend en charge les points d'analyse mais ne les indexe pas. Par conséquent, FindFirstVolumeMountPoint et FindNextVolumeMountPoint ne fonctionneront pas comme prévu.
	FILE_SUPPORTS_SPARSE_FILES	0x00000040	Cette constante permet d'indiquer que le volume spécifié prend en charge les fichiers fragmentés.
	FILE_SUPPORTS_TRANSACTIONS	0x00200000	Cette constante permet d'indiquer que le volume spécifié prend en charge les transactions.
	FILE_SUPPORTS_USN_JOURNAL	0x02000000	Cette constante permet d'indiquer que le volume spécifié prend en charge les journaux de numéro de séquence de mise à jour (USN). C'est constante n'est pas prise en charge par Windows XP et Windows Vista.
	FILE_UNICODE_ON_DISK	0x00000004	Cette constante permet d'indiquer que le volume spécifié prend en charge les noms de fichiers Unicode tels qu'ils apparaissent sur le disque.
	FILE_VOLUME_IS_COMPRESSED	0x00008000	Cette constante permet d'indiquer que le volume spécifié est un volume compressé, par exemple un volume DoubleSpace.
	FILE_VOLUME_QUOTAS	0x00000020	Cette constante permet d'indiquer que le volume spécifié prend en charge les quotas de disque.
lpFileSystemNameBuffer	Ce paramètre permet d'indiquer un pointeur sur une mémoire tampon recevant le nom du système de fichiers, par exemple, le système de fichiers FAT ou le système de fichiers NTFS. La taille de la mémoire tampon est spécifiée par le paramètre nFileSystemNameSize.
nFileSystemNameSize	Ce paramètre permet d'indiquer la longueur de la mémoire tampon du nom du système de fichiers, en TCHAR. La taille maximale de la mémoire tampon est MAX_PATH+1. Ce paramètre est ignoré si le tampon de nom de système de fichiers n'est pas fourni.

Description

Cette fonction permet de demander les informations d'entête d'une unité disque.

Remarques

Lorsqu'un utilisateur tente d'obtenir des informations sur une unité de disquette sans disquette ou sur un unité de CD-ROM sans CD-ROM, le système affiche une boîte de message permettant à l'utilisateur d'insérer une disquette ou un disque compact, respectivement. Pour empêcher le système d'afficher cette boîte de message, appelez la fonction SetErrorMode avec la constante SEM_FAILCRITICALERRORS.
Le drapeau FILE_VOL_IS_COMPRESSED est le seul drapeau de la compression basée sur le volume. Le nom du système de fichiers n'est pas modifié pour indiquer la compression. Par exemple, cet indicateur est renvoyé défini sur un volume DoubleSpace. Lorsque la compression est basée sur un volume, un volume entier est compressé ou sinon il ne l'est pas du tout.
Le drapeau FILE_FILE_COMPRESSION indique si un système de fichiers prend en charge la compression basée sur fichier. Lorsque la compression est basée sur un fichier, des fichiers individuels peuvent être compressés ou non.
Les drapeaux FILE_FILE_COMPRESSION et FILE_VOL_IS_COMPRESSED s'excluent mutuellement. Les deux bits ne peuvent pas être retournés ensemble.
La valeur de longueur maximale de composante entreposée dans lpMaximumComponentLength est le seul drapeau qu'un volume prend en charge pour des noms de fichier de système de fichiers FAT plus longs que la normale (ou d'autres systèmes de fichiers). Le nom du système de fichiers n'est pas modifié pour indiquer la prise en charge des noms de fichiers longs.
La fonction GetCompressedFileSizeA demande la taille compressée d'un fichier. La fonction GetFileAttributesA peut déterminer si un fichier individuel est compressé.

Dernière mise à jour : Dimanche, le 6 décembre 2015

Section courante

A propos

Section administrative du site

GetVolumeInformationA

Syntaxe

Paramètres

Description

Remarques