_chsize_s

Ändert die Größe einer Datei. Diese Funktion ist eine Version von _chsize Sicherheitsverbesserungen, wie in den Sicherheitsfeatures im CRT beschrieben.

Syntax

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parameter

fd
Dateideskriptoren, die auf eine geöffnete Datei verweisen.

size
Neue Länge der Datei in Bytes.

Rückgabewert

_chsize_s gibt den Wert 0 zurück, wenn die Dateigröße erfolgreich geändert wurde. Ein Rückgabewert ungleich null zeigt einen Fehler an: Der Rückgabewert ist EACCES, wenn die angegebene Datei für den Zugriff gesperrt ist, EBADF, wenn die angegebene Datei schreibgeschützt oder der Deskriptor ungültig ist, ENOSPC, wenn kein Speicherplatz mehr auf dem Gerät vorhanden ist, oder EINVAL, wenn die Größe kleiner als 0 (null) ist. errno wird auf denselben Wert festgelegt.

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

Hinweise

Die _chsize_s-Funktion erweitert oder verkürzt die mit fd verknüpfte Datei auf die von size angegebene Länge. Die Datei muss in einem Modus geöffnet sein, der Schreiben zulässt. Wenn die Datei erweitert wird, werden NULL-Zeichen ('\0') angefügt. Wenn die Datei abgeschnitten wird, gehen alle Daten vom Ende der gekürzten Datei bis zur ursprünglichen Länge der Datei verloren.

_chsize_s verwendet einen 64-Bit-Integer als Dateigröße und kann daher Dateien handhaben, die größer als 4 GB sind. _chsize ist auf 32-Bit-Dateien beschränkt.

Diese Funktion überprüft ihre Parameter. Wenn fd kein gültiger Dateideskriptor oder eine gültige Größe kleiner als 0 ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben.

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.

Anforderungen

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

Siehe auch

Dateibehandlung
_chsize
_close
_creat, _wcreat
_open, _wopen