_chsize_s

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ファイルのサイズを変更します。この関数は、「CRT のセキュリティ強化」に説明されているように、_chsize のセキュリティが強化されたバージョンです。

errno_t _chsize_s( 
   int fd,
   __int64 size 
);

パラメータ

fd
開いているファイルを参照するファイル記述子。
size
ファイルの新しい長さ (バイト単位)。

戻り値

ファイルサイズが正常に変更された場合、_chsize_s は 0 という値を返します。0 以外の値はエラーを意味します。このときの戻り値は、指定されたファイルがアクセスに対してロックされている場合は EACCES 、指定されたファイルが読み取り専用か、記述子が無効な場合は EBADF 、デバイスに領域がない場合は ENOSPC 、size が 0 未満の場合は EINVAL になります。errno は同じ値に設定されます。

リターンコードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_chsize_s 関数は、fd に関連付けられたファイルの拡張または切り捨てを実行し、size で指定された長さにファイルサイズを変更します。ファイルは書き込み許可モードで開く必要があります。ファイルが拡張された場合は、Null 文字 ('\0') が追加されます。ファイルが切り捨てられた場合は、切り捨て後のファイルの終端から元のファイル長までに含まれていたデータがすべて失われます。

_chsize_s 関数は、ファイルサイズとして 64 ビット整数を使用するため、、4GB を超えるファイルサイズを処理できます。_chsize 関数は、32 ビットのファイルサイズに制限されます。

この関数は、パラメータを検証します。fd が無効なファイル記述子の場合または 0 未満の場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。