setEndOfFile 函数 (fileapi.h)

将指定文件的物理文件大小设置为文件指针的当前位置。

物理文件大小也称为文件末尾。 SetEndOfFile 函数可用于截断或扩展文件。若要设置文件的逻辑端，请使用 SetFileValidData 函数。

语法

BOOL SetEndOfFile(
  [in] HANDLE hFile
);

[in] hFile

要扩展或截断的文件的句柄。

必须使用 GENERIC_WRITE 访问权限创建文件句柄。有关详细信息，请参阅文件安全和访问权限。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零 (0)。要获得更多的错误信息，请调用 GetLastError。

SetEndOfFile 函数可用于截断或扩展文件。如果文件已扩展，则不会定义文件旧端与文件新端之间的文件内容。

每个文件流具有以下项：

SetEndOfFile 函数设置文件大小。使用 SetFileValidData 设置有效的数据长度。

如果
调用 CreateFileMapping 为 hFile 创建文件映射对象，必须先调用 UnmapViewOfFile 以取消映射所有视图，并调用 CloseHandle 以关闭文件映射对象，然后才能调用 SetEndOfFile。

如果存在绑定到句柄的事务，则会事务处理文件末尾位置的更改。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。