_unlink, _wunlink

Artikel
02/26/2013

Löschen einer Datei

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

Parameter

filename
Name der Datei zu entfernen.

Rückgabewert

Jede dieser Funktionen gibt 0 zurück, wenn der Vorgang erfolgreich war.Andernfalls gibt die Funktion 1 zurück und legt ihn fest EACCESzu errno , was bedeutet, dass der Pfad eine schreibgeschützte Datei angegeben wird oder ENOENT, das heißt die Datei oder der Pfad nicht gefunden wird oder der Pfad eines Verzeichnisses angegeben hat.

Weitere Informationen finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr Weitere Informationen über diese und andere Rückgabecodes.

Hinweise

Die _unlink-Funktion löscht die Datei, die von filenameangegeben wird._wunlink ist eine Breitzeichen-Version von _unlink. filename das Argument zu _wunlink ist eine Zeichenfolge mit Breitzeichen.Diese Funktionen verhalten sich ansonsten unterscheiden.

Zuweisung generischer Textroutinen

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

Anforderungen

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

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

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" );
}