UDF > WinAPIEx > Files & Devices > Files >


_WinAPI_GetFileID

Obtient le numéro de référence fichier, de 8 octets, d'un fichier

#include <WinAPIFiles.au3>
_WinAPI_GetFileID ( $hFile )

Paramètre

$hFile Le handle du fichier ou du répertoire dont vous voulez le numéro de référence.

Valeur de retour

Succès: Retourne le numéro de référence de fichier de 8 octets pour le fichier.
Échec: Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur NTSTATUS.

Remarques

Le numéro de référence de fichier est attribué par le système de fichiers et est spécifique au système de fichiers.
(Notez que ce n'est pas le même que le "file object ID" de 16 octets qui a été ajouté au format NTFS.)

Les numéros de référence de fichier, aussi appelé ID de fichiers, sont garantis être uniques seulement dans un système de fichiers statique.
Ils ne sont pas garantis être unique au cours du temps, parce que les systèmes de fichiers sont libres de les réutiliser.
Ils ne sont pas garantis rester constant.
Par exemple, le système de fichiers FAT génère le numéro de référence de fichier pour un fichier à partir de l'offset de l'enregistrement d'entrée de répertoire du fichier (DIRENT) sur le disque.
La défragmentation peut changer ce décalage d'octet.
Ainsi, un numéro de référence de fichier FAT peut changer au cours du temps.

Voir aussi

Consultez ZwQueryInformationFile dans la librairie MSDN.

Exemple

#include <WinAPIFiles.au3>
#include <WinAPIHObj.au3>

Local $hFile = _WinAPI_CreateFile(@ScriptFullPath, 2, 0, 6)

ConsoleWrite('Handle: ' & $hFile & @CRLF)
ConsoleWrite('ID:     ' & _WinAPI_GetFileID($hFile) & @CRLF)

_WinAPI_CloseHandle($hFile)