SetEndOfFile

指定されたファイルのファイル終端（EOF）の位置を、現在のファイルポインタの位置に移動させます。

BOOL SetEndOfFile(
    HANDLE hFile     // file handle
);

KERNEL32.DLL

引数

hFile

ファイル終端（EOF）の位置を移動させるファイルのハンドルを指定します。このハンドルはGENERIC_WRITEアクセス権を持っていなければなりません。

戻り値

成功すると0以外の値が返ります。

失敗すると0が返ります。拡張エラー情報を取得するには、GetLastError関数を使います。

解説

この関数を使用してファイルサイズを切り捨てや拡張を行うことができます。ファイルサイズが拡張された場合、以前のファイル終端から新しいファイル終端までのファイルの内容は定義されていません。

CreateFileMapping関数によって対象ファイルのファイルマッピングオブジェクトが作成されている場合には、まずUnmapViewOfFile関数を呼び出してすべてのビューをマッピング解除し、CloseHandle関数を呼び出してファイルマッピングオブジェクトをクローズした後でSetEndOfFile関数を呼び出さなくてはなりません。

対応情報

Windows 95 以降 / Windows NT 3.1 以降