_chsize_s

Article
03/04/2013

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é du CRT.

errno_t _chsize_s( 
   int fd,
   __int64 size 
);

Paramètres

fd
Descripteur de fichier référence à un fichier ouvert.
size
nouvelle longueur du fichier en octets.

Valeur de retour

_chsize_sretourne la valeur 0 si la taille du fichier est correctement modifiée.une valeur de retour différente de zéro indique une erreur : la valeur de retour est EACCESsi le fichier spécifié est verrouillé contre l'accès, EBADFsi le fichier spécifié est en lecture seule ou le descripteur est valide, ENOSPCsi aucun espace n'est autorisé sur le périphérique, ou EINVALsi la taille est inférieur à zéro.errnoont la même valeur.

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

Notes

La fonction d' _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 d'écrire.Les caractères Null (" \ 0 ") sont ajoutés si le fichier est étendu.Si le fichier est tronqué, toutes les données de la fin de le fichier raccourci vers la longueur d'origine du fichier est perdue.

_chsize_saccepte un entier 64 bits comme une taille du fichier, et peut donc gérer Go supérieur de taille des fichiers à 4._chsizeest limité aux tailles des fichiers 32 bits.

cette fonction valide ses paramètres.Si fd n'est pas un descripteur de fichier non valide ou la taille est inférieur à zéro, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.