Fonction UnlockFileEx (fileapi.h)

Article
08/23/2023

Déverrouille une région dans le fichier spécifié. Cette fonction peut fonctionner de manière synchrone ou asynchrone.

Syntaxe

BOOL UnlockFileEx(
  [in]      HANDLE       hFile,
            DWORD        dwReserved,
  [in]      DWORD        nNumberOfBytesToUnlockLow,
  [in]      DWORD        nNumberOfBytesToUnlockHigh,
  [in, out] LPOVERLAPPED lpOverlapped
);

Paramètres

[in] hFile

Descripteur du fichier. Le handle doit avoir été créé avec le droit d’accès GENERIC_READ ou GENERIC_WRITE . Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.

dwReserved

Paramètre réservé ; doit être égal à zéro.

[in] nNumberOfBytesToUnlockLow

Partie d’ordre inférieur de la longueur de la plage d’octets à déverrouiller.

[in] nNumberOfBytesToUnlockHigh

Partie d’ordre élevé de la longueur de la plage d’octets à déverrouiller.

[in, out] lpOverlapped

Pointeur vers une structure OVERLAPPED que la fonction utilise avec la demande de déverrouillage. Cette structure contient le décalage de fichier du début de la plage de déverrouillage. Vous devez initialiser le membre hEvent sur un handle valide ou zéro. Pour plus d’informations, consultez E/S synchrones et asynchrones.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est zéro ou NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Le déverrouillage d’une région d’un fichier libère un verrou précédemment acquis sur le fichier. La région à déverrouiller doit correspondre exactement à une région verrouillée existante. Deux régions adjacentes d’un fichier ne peuvent pas être verrouillées séparément, puis déverrouillées à l’aide d’une seule région qui s’étend sur les deux régions verrouillées.

Les verrous sont libérés avant la fin du traitement de la fonction CloseHandle .

Dans 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

Configuration requise


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