Función UnlockFileEx (fileapi.h)

Artículo
08/23/2023

Desbloquea una región del archivo especificado. Esta función puede funcionar de forma sincrónica o asincrónica.

Sintaxis

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

Parámetros

[in] hFile

Identificador del archivo. El identificador debe haberse creado con el derecho de acceso GENERIC_READ o GENERIC_WRITE . Para obtener más información, vea Derechos de acceso y seguridad de archivos.

dwReserved

Parámetro reservado; debe ser cero.

[in] nNumberOfBytesToUnlockLow

Parte de orden bajo de la longitud del intervalo de bytes que se va a desbloquear.

[in] nNumberOfBytesToUnlockHigh

La parte de orden superior de la longitud del intervalo de bytes que se va a desbloquear.

[in, out] lpOverlapped

Puntero a una estructura SUPERPUESTA que la función usa con la solicitud de desbloqueo. Esta estructura contiene el desplazamiento de archivo del principio del intervalo de desbloqueo. Debe inicializar el miembro hEvent en un identificador válido o cero. Para obtener más información, vea E/S sincrónica y asincrónica.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero o NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Desbloquear una región de un archivo libera un bloqueo adquirido anteriormente en el archivo. La región que se va a desbloquear debe corresponder exactamente a una región bloqueada existente. Dos regiones adyacentes de un archivo no se pueden bloquear por separado y, a continuación, desbloquearse mediante una sola región que abarca ambas regiones bloqueadas.

Los bloqueos se liberan antes de que finalice el procesamiento de la función CloseHandle .

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología	Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0	Sí
Conmutación por error transparente (TFO) de SMB 3.0	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Sí
Sistema de archivos resistente a errores (ReFS)	Sí

Requisitos


Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	fileapi.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll