_chsize_s
Ändert die Größe einer Datei. Dies ist eine Version von _chsize mit werden, wie in Sicherheitsfunktionen in der CRT beschrieben.
errno_t _chsize_s(
int fd,
__int64 size
);
Parameter
fd
Dateideskriptor, der eine geöffnete Datei verweist.size
Neue Länge einer Datei in Bytes.
Rückgabewert
_chsize_s gibt den Wert 0 zurück, wenn die Dateigröße erfolgreich geändert wird. Bei dem Rückgabewert ungleich 0 (null) gibt einen Fehler an: der Rückgabewert ist EACCES , wenn die angegebene Datei mit Zugriff beschränkt ist, EBADF , wenn die angegebene Datei schreibgeschützt ist, der ein oder ungültig ist, ENOSPC , wenn kein Platz auf dem Gerät vorhanden ist, oder EINVAL , wenn Größe kleiner als null ist. errno wird auf den Wert festgelegt.
Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die _chsize_s -Funktion erweitert oder schneidet die Datei ab, die mit fd zur Länge zugeordnet wird, die von size angegeben wird. Die Datei muss in einem Modus geöffnet werden, ermöglicht der zu schreiben. NULL-Zeichen ("\ 0 ") angefügt werden, wenn sie erweitert wird. Wenn die Datei abgeschnitten wird, wurden alle Daten vom Ende der komprimierten Datei zur ursprünglichen Größe der Datei verloren.
_chsize_s nimmt eine 64-Bit-Ganzzahl als die Dateigröße und Dateigrößen kann größer als 4 GB daher behandeln. Ein _chsize wird an 32-Bit-Dateigrößen beschränkt.
Diese Funktion überprüft ihre Parameter. Wenn fd kein gültiger Dateideskriptor ist, Größe oder kleiner als null ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.
Anforderungen
Routine |
Erforderlicher Header |
Optionaler Header |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.