_locking

Bloqueia ou desbloqueia os bytes de um arquivo.

Sintaxe

int _locking(
   int fd,
   int mode,
   long nbytes
);

Parâmetros

fd
Descritor de arquivo.

mode
Bloqueio de ação a ser executada.

nbytes
O número de bytes a serem bloqueados.

Retornar valor

_locking retorna 0 se for bem-sucedido. Um valor de retorno de -1 indica falha, caso errno em que é definido como um dos seguintes valores.

errno valor	Condição
EACCES	Violação de bloqueio (arquivo já foi bloqueado ou desbloqueado).
EBADF	Descritor de arquivo inválido.
EDEADLOCK	Violação de bloqueio. Retornado quando o sinalizador ou _LK_RLCK é especificado e o _LK_LOCK arquivo não pode ser bloqueado após 10 tentativas.
EINVAL	Um argumento inválido foi fornecido a _locking.

Se a falha for devido a um parâmetro inválido, como um descritor de arquivo inválido, o manipulador de parâmetros inválido será chamado, conforme descrito em Validação de parâmetro.

Comentários

A _locking função bloqueia ou desbloqueia nbytes bytes do arquivo especificado pelo fd. Os bytes bloqueados em um arquivo impedem o acesso a esses bytes por outros processos. Todo o bloqueio ou desbloqueio começa na posição atual do ponteiro do arquivo e prossegue para os próximos nbytes bytes. É possível bloquear bytes após o final do arquivo.

mode deve ser uma das seguintes constantes de manifesto, que são definidas em Locking.h.

mode valor	Efeito
_LK_LOCK	Bloqueia os bytes especificados. Se os bytes não puderem ser bloqueados, o programa tentará imediatamente novamente após 1 segundo. Se os bytes não puderem ser bloqueados após 10 tentativas, a constante retornará um erro.
_LK_NBLCK	Bloqueia os bytes especificados. Se os bytes não puderem ser bloqueados, a constante retornará um erro.
_LK_NBRLCK	Mesmo que _LK_NBLCK.
_LK_RLCK	Mesmo que _LK_LOCK.
_LK_UNLCK	Desbloqueia os bytes especificados, que devem ter sido bloqueados anteriormente.

Várias regiões de um arquivo que não se sobrepõem podem ser bloqueadas. Uma região que está sendo desbloqueada deve ter sido bloqueada anteriormente. _locking não mescla regiões adjacentes; Se duas regiões bloqueadas estiverem adjacentes, cada região deverá ser desbloqueada separadamente. Regiões devem ser bloqueadas por um curto período de tempo e devem ser desbloqueadas antes de fechar um arquivo ou sair do programa.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_locking	<io.h> e <sys/locking.h>	<errno.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Exemplo

// crt_locking.c
/* This program opens a file with sharing. It locks
* some bytes before reading them, then unlocks them. Note that the
* program works correctly only if the file exists.
*/

#include <sys/types.h>
#include <sys/stat.h>
#include <sys/locking.h>
#include <share.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <io.h>

int main( void )
{
   int  fh, numread;
   char buffer[40];

   /* Quit if can't open file or system doesn't
    * support sharing.
    */
   errno_t err = _sopen_s( &fh, "crt_locking.txt", _O_RDONLY, _SH_DENYNO,
                          _S_IREAD | _S_IWRITE );
   printf( "%d %d\n", err, fh );
   if( err != 0 )
      exit( 1 );

   /* Lock some bytes and read them. Then unlock. */
   if( _locking( fh, LK_NBLCK, 30L ) != -1 )
   {
      long lseek_ret;
      printf( "No one can change these bytes while I'm reading them\n" );
      numread = _read( fh, buffer, 30 );
      buffer[30] = '\0';
      printf( "%d bytes read: %.30s\n", numread, buffer );
      lseek_ret = _lseek( fh, 0L, SEEK_SET );
      _locking( fh, LK_UNLCK, 30L );
      printf( "Now I'm done. Do what you will with them\n" );
   }
   else
      perror( "Locking failed\n" );

   _close( fh );
}

Entrada: crt_locking.txt

The first thirty bytes of this file will be locked.

Saída de exemplo

No one can change these bytes while I'm reading them
30 bytes read: The first thirty bytes of this
Now I'm done. Do what you will with them

Confira também

Manipulação de arquivos
_creat, _wcreat
_open, _wopen