_chsize_s
Ändert die Größe einer Datei.Dies ist eine Version von _chsize mit unter Security Enhancements, wie in Sicherheitsfeatures im CRTbeschrieben.
errno_t _chsize_s(
int fd,
__int64 size
);
Parameter
fd
Dateideskriptor, der eine offene Datei verweist.size
Die neue Länge der Datei in Byte.
Rückgabewert
_chsize_sgibt den Wert 0 zurück, wenn die Dateigröße erfolgreich geändert wurde.Ein Wert ungleich 0 (null) gibt 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 ist oder der Deskriptor ungültig ist, ENOSPC, wenn kein Speicherplatz auf dem Gerät gelassen wird, oder EINVAL, wenn ihre Größe weniger als null ist.errnowird auf den gleichen Wert festgelegt.
Weitere Informationen über diese und andere Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die _chsize_sFunktion erweitert oder schneidet die Datei ab, die fd auf die Länge zugeordnet ist, die von sizeangegeben wird.Die Datei muss in einem Modus geöffnet werden kann, der geschrieben werden soll.NULL-Zeichen („\ 0") werden angefügt, wenn die Datei erweitert wird.Wenn die Datei abgeschnitten wird, ist alle Daten aus dem Ende der verkürzten Datei zur ursprünglichen Länge der Datei verloren.
_chsize_snimmt eine 64-Bit-Ganzzahl als die Dateigröße und kann daher der Dateigrößen verarbeiten, die größer als 4 GB sind._chsizewird an 32-Bit-Dateigrößen beschränkt.
Diese Funktion überprüft seine Parameter.Wenn fd kein gültiger Dateideskriptor oder Größe kleiner als null ist, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.
Anforderungen
Routine |
Erforderlicher Header |
Optionaler Header |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.