Freigeben über


_unlink, _wunlink

Löschen Sie eine Datei.

Syntax

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

Parameter

filename
Name der zu entfernenden Datei.

Rückgabewert

Jede dieser Funktionen gibt bei Erfolg 0 zurück. Andernfalls gibt die Funktion -1 zurück und legt sie errno EACCESauf fest, was bedeutet, dass der Pfad eine schreibgeschützte Datei oder ein Verzeichnis oder ein ENOENTVerzeichnis angibt, was bedeutet, dass die Datei oder der Pfad nicht gefunden wird.

Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die _unlink-Funktion löscht die von filename angegebene Datei. _wunlink ist eine Breitzeichenversion von _unlink. Das filename -Argument für _wunlink ist eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

TCHAR.H-Routine _UNICODE und _MBCS nicht definiert _MBCS definiert _UNICODE definiert
_tunlink _unlink _unlink _wunlink

Anforderungen

Routine Erforderlicher Header
_unlink <io.h> und <stdio.h>
_wunlink <io.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Codebeispiel

Dieses Programm verwendet _unlink, um CRT_UNLINK.TXT zu löschen.

// crt_unlink.c

#include <stdio.h>

int main( void )
{
   if( _unlink( "crt_unlink.txt" ) == -1 )
      perror( "Could not delete 'CRT_UNLINK.TXT'" );
   else
      printf( "Deleted 'CRT_UNLINK.TXT'\n" );
}

Eingabe: crt_unlink.txt

This file will be deleted.

Beispielausgabe

Deleted 'CRT_UNLINK.TXT'

Siehe auch

Dateibehandlung
_close
remove, _wremove