Compartilhar via


_lock_file

Bloqueia um objeto de FILE para garantir a consistência dos threads que acessam o objeto de FILE simultaneamente.

void _lock_file(
   FILE* file
);

Parâmetros

  • file
    Identificador de arquivo.

Comentários

A função de _lock_file bloqueia o objeto de FILE especificado por file. O arquivo subjacente não estiver bloqueado por _lock_file. Use _unlock_file para liberar o bloqueio no arquivo. As chamadas a _lock_file e _unlock_file devem ser comparados em um thread.

Requisitos

Rotina

Cabeçalho necessário

_lock_file

<stdio.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_lock_file.c
// This example creates multiple threads that write to standard output
// concurrently, first with _file_lock, then without.

#include <stdio.h>
#include <process.h>// _beginthread
#include <windows.h>// HANDLE

void Task_locked( void* str )
{
    for( int i=0; i<1000; ++i )
    {
        _lock_file( stdout );
        for( char* cp = (char*)str; *cp; ++cp )
        {
            _fputc_nolock( *cp, stdout );
        }
        _unlock_file( stdout );
    }
}

void Task_unlocked( void* str )
{
    for( int i=0; i<1000; ++i )
    {
        for( char* cp = (char*)str; *cp; ++cp )
        {
            fputc( *cp, stdout );
        }
    }
}

int main()
{
    HANDLE h[3];
    h[0] = (HANDLE)_beginthread( &Task_locked, 0, "First\n" );
    h[1] = (HANDLE)_beginthread( &Task_locked, 0, "Second\n" );
    h[2] = (HANDLE)_beginthread( &Task_locked, 0, "Third\n" );

    WaitForMultipleObjects( 3, h, true, INFINITE );

    h[0] = (HANDLE)_beginthread( &Task_unlocked, 0, "First\n" );
    h[1] = (HANDLE)_beginthread( &Task_unlocked, 0, "Second\n" );
    h[2] = (HANDLE)_beginthread( &Task_unlocked, 0, "Third\n" );

    WaitForMultipleObjects( 3, h, true, INFINITE );
}
  

Equivalência do .NET Framework

System::IO::FileStream::Lock

Consulte também

Referência

Manipulação de arquivos

_creat, _wcreat

_open, _wopen

_unlock_file