`_chsize_s`

Article
10/12/2023

Modifie la taille d’un fichier. Cette fonction est une version des améliorations de _chsize sécurité décrites dans les fonctionnalités de sécurité du CRT.

Syntaxe

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, en octets, du fichier.

Valeur retournée

_chsize_s retourne 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 : 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 en l’absence d’espace disponible sur le périphérique ou EINVAL si la taille est inférieure à zéro. errno est défini sur la même valeur.

Pour plus d’informations sur ces codes de retour et d’autres codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La fonction _chsize_s é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. Des caractères Null (« \0 ») sont ajoutés si le fichier est étendu. Si le fichier est tronqué, toutes les données depuis la fin du fichier raccourci jusqu’à la longueur d’origine du fichier sont perdues.

_chsize_s, qui accepte un entier 64 bits comme taille de fichier, peut gérer des tailles de fichier supérieures à 4 Go. _chsize est limité aux tailles de fichier 32 bits.

Cette fonction valide ses paramètres. S’il fd n’est pas un descripteur de fichier valide ou si la taille est inférieure à zéro, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Routine	En-tête requis	En-tête facultatif
`_chsize_s`	<io.h>	<errno.h>

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

Voir aussi

Gestion des fichiers
_chsize
_close
_creat, _wcreat
_open, _wopen

Partage via