Funzione UnlockFileEx (fileapi.h)
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 |