Nous recommandons d’utiliser Visual Studio 2017

_chsize_s

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Modifie la taille d’un fichier. Il s’agit d’une version de _chsize avec des améliorations de sécurité comme décrit dans fonctionnalités de sécurité de la bibliothèque CRT.

errno_t _chsize_s(   
   int fd,  
   __int64 size   
);  

Paramètres

fd
Descripteur de fichier qui fait référence à un fichier ouvert.

size
Nouvelle longueur du fichier en octets.

_chsize_sRetourne la valeur 0 si la taille du fichier a été correctement modifiée. Une valeur de retour différente de zéro indique une erreur : la valeur de retour est EACCES si le fichier spécifié est verrouillé contre tout accès, EBADF si le fichier spécifié est en lecture seule ou si le descripteur n’est pas valide, ENOSPC si plus d’espace disponible sur le périphérique, ou EINVAL si la taille est inférieure à zéro. errnoa la même valeur.

Pour plus d'informations sur ces codes de retour et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Le _chsize_s fonction étend ou tronque le fichier associé fd à la longueur spécifiée par size. Le fichier doit être ouvert dans un mode qui permet l’écriture. Les caractères null ('\0') sont ajoutées si le fichier est étendu. Si le fichier est tronqué, toutes les données à partir de la fin du fichier raccourcie à la longueur du fichier d’origine sont perdues.

_chsize_saccepte un entier 64 bits en tant que la taille du fichier et par conséquent peut gérer des tailles de fichiers supérieurs à 4 Go. _chsizeest limité aux tailles de fichiers 32 bits.

Cette fonction valide ses paramètres. Si fd n’est pas un descripteur de fichier valide ou la taille est inférieure à zéro, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre.

RoutineEn-tête requisEn-tête facultatif
_chsize_s<io.h><errno.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility dans l’introduction.

Gestion de fichiers
_chsize
_close
_creat, _wcreat
_open, _wopen

Afficher: