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.

Requisiti

Vedere anche

Blocco e sblocco degli intervalli di byte nei file

CreateFile

Funzioni di gestione file

LockFile

LockFileEx

SOVRAPPOSTA

I/O sincrono e asincrono

UnlockFile