UnlockFileEx
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função desbloqueia uma região em aberto um arquivo. Desbloquear uma região permite que outros processos para acessar a região.
Syntax
BOOL UnlockFileEx(
HANDLE hFile,
DWORD dwReserved,
DWORD nNumberOfBytesToLockLow,
DWORD nNumberOfBytesToLockHigh,
LPOVERLAPPED lpOverlapped
);
Parameters
- hFile
[no] Identificador para um arquivo que contém uma Região bloqueada pela função LockFileEx. O identificador de arquivo deve ter sido criado com o direito de acesso GENERIC_READ ou GENERIC_WRITE.
- dwReserved
Reservado. Definido como zero.
- nNumberOfBytesToLockLow
[no] Baixo-parte ordem do comprimento do intervalo de byte para desbloquear.
- nNumberOfBytesToLockHigh
[no] Alto-parte ordem do comprimento do intervalo de byte para desbloquear.
- lpOverlapped
[no] Ponteiro para uma estrutura OVERLAPPED que é usada com a solicitação de desbloqueio. Essa estrutura contém o arquivo deslocamento do início do intervalo de desbloqueio.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas, chamar GetLastError.
Remarks
Desbloquear uma região de um arquivo libera um bloqueio adquirido anteriormente sobre o arquivo. A região para desbloquear deve corresponder exatamente para uma existente bloqueado região. Dois adjacente regiões de um arquivo não podem ser bloqueado separadamente e, em seguida, destrave usando uma única região que abranja ambas as regiões bloqueadas.
Se um processo termina com uma parte de um arquivo bloqueado ou fecha um arquivo que tenha pendente bloqueios, os bloqueios são desbloqueados pela OS. No entanto, o tempo que leva para o OS para desbloquear esses bloqueios depende disponível recursos sistema. Portanto, bloqueado desbloquear explicitamente todos os arquivos quando termina um processo. Caso contrário, acessar a esses arquivos pode ser negado se a OS tem não ainda desbloqueada-los.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |