Funzione UnlockFileEx (fileapi.h)

Articolo
08/23/2023

Sblocca un'area nel file specificato. Questa funzione può operare in modo sincrono o asincrono.

Sintassi

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

Parametri

[in] hFile

Handle per il file. L'handle deve essere stato creato con il diritto di accesso GENERIC_READ o GENERIC_WRITE . Per altre informazioni, vedere Protezione dei file e diritti di accesso.

dwReserved

Parametro riservato; deve essere zero.

[in] nNumberOfBytesToUnlockLow

Parte bassa della lunghezza dell'intervallo di byte da sbloccare.

[in] nNumberOfBytesToUnlockHigh

Parte alta della lunghezza dell'intervallo di byte da sbloccare.

[in, out] lpOverlapped

Puntatore a una struttura OVERLAPPED usata dalla funzione con la richiesta di sblocco. Questa struttura contiene l'offset del file all'inizio dell'intervallo di sblocco. È necessario inizializzare il membro hEvent in un handle valido o zero. Per altre informazioni, vedere I/O sincrono e asincrono.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero o NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Sbloccare un'area di un file rilascia un blocco acquisito in precedenza nel file. L'area da sbloccare deve corrispondere esattamente a un'area bloccata esistente. Due aree adiacenti di un file non possono essere bloccate separatamente e quindi sbloccate usando una singola area che si estende su entrambe le aree bloccate.

I blocchi vengono rilasciati prima del completamento dell'elaborazione della funzione CloseHandle .

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	Sì
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (ReFS)	Sì

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll