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 |