unlock

Nach oben zu io.h - Index

Header-Datei

io.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int unlock(int handle, long offset, long length);

Beschreibung

Hebt Sperren für die gemeinsame Nutzung von Dateien auf.

unlock stellt eine Schnittstelle für den Betriebssystemmechanismus zur gemeinsamen Nutzung von Dateien zur Verfügung. Mit unlock wird eine Sperre aufgehoben, die zuvor durch einen Aufruf von lock gesetzt wurde. Um Fehler zu vermeiden, müssen alle Sperren entfernt werden, bevor eine Datei geschlossen wird. Ein Programm muss vor der Beendigung sämtliche Sperren aufheben.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion unlock 0 zurück.

Im Fehlerfall gibt sie -1 zurück.

Beispiel

 #include <io.h>
 #include <fcntl.h>
 #include <sys\stat.h>;
 #include <process.h>
 #include <share.h>
 #include <stdio.h>
 int main(void)
 {
    int handle, status;
    long length;
    handle = _sopen("c:\\autoexec.bat",O_RDONLY,SH_DENYNO,S_IREAD);
    if (handle < 0)
    {
        printf("_sopen failed\n");
        exit(1);
    }
    length = filelength(handle);
    status = lock(handle,0L,length/2);
    if (status == 0)
       printf("lock succeeded\n");
    else
       printf("lock failed\n");
    status = unlock(handle,0L,length/2);
    if (status == 0)
       printf("unlock succeeded\n");
    else
       printf("unlock failed\n");
    close(handle);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+