GetFileInformationByHandle, fonction (fileapi.h)

Récupère les informations relatives au fichier spécifié.

Pour obtenir une version plus avancée de cette fonction, consultez GetFileInformationByHandleEx.

Pour définir des informations de fichier à l’aide d’un handle de fichier, consultez SetFileInformationByHandle.

Syntaxe

BOOL GetFileInformationByHandle(
  [in]  HANDLE                       hFile,
  [out] LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);

Paramètres

[in] hFile

Handle du fichier qui contient les informations à récupérer.

Ce handle ne doit pas être un handle de canal.

[out] lpFileInformation

Pointeur vers une structure de BY_HANDLE_FILE_INFORMATION qui reçoit les informations de fichier.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro et les données d’informations de fichier sont contenues dans la mémoire tampon pointée vers le paramètre lpFileInformation .

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

Selon les fonctionnalités réseau sous-jacentes du système d’exploitation et le type de serveur auquel il est connecté, la fonction GetFileInformationByHandle peut échouer, renvoyer des informations partielles ou des informations complètes pour le fichier donné.

Vous pouvez comparer les membres VolumeSerialNumber et FileIndex retournés dans la structure BY_HANDLE_FILE_INFORMATION pour déterminer si deux chemins sont mappés à la même cible ; par exemple, vous pouvez comparer deux chemins d’accès de fichiers et déterminer s’ils sont mappés au même répertoire.

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

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Oui
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

 

Opérations traitées

S’il existe une transaction liée au thread au moment de l’appel, la fonction retourne la taille de fichier compressée de l’affichage de fichiers isolé. Pour plus d’informations, consultez À propos de NTFS transactionnel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de gestion des fichiers

GetFileInformationByHandleEx

SetFileInformationByHandle