Función UnlockFileEx (fileapi.h)
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 |
Vea también
Bloqueo y desbloqueo de intervalos de bytes en archivos