GetVolumeInformationByHandleW, fonction (fileapi.h)

Récupère des informations sur le système de fichiers et le volume associés au fichier spécifié.

Pour récupérer l’état de compression actuel d’un fichier ou d’un répertoire, utilisez FSCTL_GET_COMPRESSION.

Syntaxe

BOOL GetVolumeInformationByHandleW(
  [in]            HANDLE  hFile,
  [out, optional] LPWSTR  lpVolumeNameBuffer,
  [in]            DWORD   nVolumeNameSize,
  [out, optional] LPDWORD lpVolumeSerialNumber,
  [out, optional] LPDWORD lpMaximumComponentLength,
  [out, optional] LPDWORD lpFileSystemFlags,
  [out, optional] LPWSTR  lpFileSystemNameBuffer,
  [in]            DWORD   nFileSystemNameSize
);

Paramètres

[in] hFile

Descripteur du fichier.

[out, optional] lpVolumeNameBuffer

Pointeur vers une mémoire tampon qui reçoit le nom d’un volume spécifié. La taille maximale de la mémoire tampon est MAX_PATH+1.

[in] nVolumeNameSize

Longueur d’une mémoire tampon de nom de volume, en WCHARs. La taille maximale de la mémoire tampon est MAX_PATH+1.

Ce paramètre est ignoré si la mémoire tampon de nom de volume n’est pas fournie.

[out, optional] lpVolumeSerialNumber

Pointeur vers une variable qui reçoit le numéro de série du volume.

Ce paramètre peut avoir la valeur NULL si le numéro de série n’est pas requis.

Cette fonction retourne le numéro de série du volume attribué par le système d’exploitation lorsqu’un disque dur est mis en forme. Pour obtenir par programmation le numéro de série du disque dur attribué par le fabricant, utilisez la propriété WMI (Windows Management Instrumentation) Win32_PhysicalMediaSerialNumber.

[out, optional] lpMaximumComponentLength

Pointeur vers une variable qui reçoit la longueur maximale, en WCHAR, d’un composant de nom de fichier pris en charge par un système de fichiers spécifié.

Un composant de nom de fichier est la partie d’un nom de fichier entre des barres obliques inverses.

La valeur stockée dans la variable vers laquelle *lpMaximumComponentLength pointe 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 qui prend en charge les noms longs, la fonction stocke la valeur 255, plutôt que l’indicateur 8.3 précédent. Les noms longs peuvent également être pris en charge sur les systèmes qui utilisent le système de fichiers NTFS.

[out, optional] lpFileSystemFlags

Pointeur vers une variable qui reçoit des indicateurs associés au système de fichiers spécifié.

Ce paramètre peut être un ou plusieurs des indicateurs suivants. Toutefois, FILE_FILE_COMPRESSION et FILE_VOL_IS_COMPRESSED s’excluent mutuellement.

[out, optional] lpFileSystemNameBuffer

Pointeur vers une mémoire tampon qui reçoit 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 mémoire tampon est spécifiée par le paramètre nFileSystemNameSize .

[in] nFileSystemNameSize

Longueur de la mémoire tampon du nom du système de fichiers, en WCHARs. La taille maximale de la mémoire tampon est MAX_PATH+1.

Ce paramètre est ignoré si la mémoire tampon du nom du système de fichiers n’est pas fournie.

Valeur retournée

Si toutes les informations demandées sont récupérées, la valeur de retour est différente de zéro.

Si toutes les informations demandées ne sont pas récupérées, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

SMB ne prend pas en charge les fonctions de gestion des volumes.

Spécifications

Voir aussi

À propos de KTM

Chiffrement de fichiers

GetCompressedFileSize

GetFileAttributes

GetVolumeInformation

SetErrorMode

SetVolumeLabel

Fonctions de gestion des volumes