_chsize_s
La modifica della dimensione di un file.Si tratta di una versione di _chsize con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Parametri
fd
Descrittore del file che fa riferimento a un file aperto.size
Nuova lunghezza in byte del file.
Valore restituito
_chsize_srestituisce il valore 0 se le dimensioni del file correttamente vengono modificate.un valore restituito diverso da zero indica un errore: il valore restituito è EACCESse il file specificato non può essere accesso, EBADFse il file specificato è di sola lettura o il descrittore non è valido, ENOSPCse nessuno spazio viene lasciato nel dispositivo, o EINVALse la dimensione è minore di zero.errnoè impostato sullo stesso valore.
Per ulteriori informazioni su questi e altri codici restituiti, vedere _doserrno, errno, _sys_errlist e _sys_nerr.
Note
_chsize_sla funzione estende o tronca il file associato fd alla lunghezza specificata da size.Il file deve essere aperto in una modalità che consente di scrivere.I caratteri null (" \ 0 ") vengono aggiunti se il file viene distribuito.Se il file viene troncato, tutti i dati dalla fine del file abbreviato alla lunghezza originale del file verranno persi.
_chsize_saccetta un intero a 64 bit come le dimensioni del file e quindi possibile gestire i file di dimensioni maggiori di 4 GB._chsizeè limitato alle dimensioni del file a 32 bit.
Questa funzione convalida dei parametri.se fd non è un descrittore di file valido o la dimensione è minore di zero, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.
Requisiti
routine |
Intestazione di associazione |
intestazione facoltativa |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Per ulteriori informazioni sulla compatibilità, vedere compatibilità nell'introduzione.