_chsize_s
Changes the size of a file. Il s'agit de versions de dk925tyb(v=vs.120).mdFonctionnalités de sécurité dans le CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Paramètres
fd
Descripteurs de fichier faisant référence au fichier ouvert.size
Longueur du fichier en octets.
Valeur de retour
_chsize_s retourne la valeur 0 si la taille du fichier a été modifiée. Une valeur de retour de – 1 indique une erreur : la valeur retournée 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 l'un des descripteurs est invalide, ENOSPC si aucun espace ne reste sur le périphérique,ou EINVAL si la taille est inférieure à 0. errno est définie à la meme valeur.
Pour plus d'informations sur ces codes de retour et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.
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 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 du fichier original raccourci sont perdues.
_chsize_s prend un entier 64 bits comme taille de fichier, et peut donc gérer des tailles de fichier plus grande que 4 Gigas. _chsize est limité aux tailles de fichier 32 bits.
Cette fonction valide ses paramètres. Si fd n'est pas un descripteur de fichier valide ou si la taille est inférieure à zéro, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre.
Configuration requise
Routine |
En-tête requis |
En-tête facultatif |
|---|---|---|
_chsize_s |
<io.h,> |
<errno.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.