winbase.h


SetEndOfFile

Mueve la posición del fin de fichero (EOF) para el fichero especificado a la posición actual del puntero del fichero.

Sintaxis

BOOL SetEndOfFile(
    HANDLE hFile  // manipulador de fichero cuyo EOF se actualizará
   );

Parámetros:

hFile: identifica el fichero para el que se modificará su posición de EOF. El manipulador de fichero debe haber sido creado con acceso GENERIC_WRITE al fichero.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Esta función puede ser usada para truncar o alargar un fichero. Si el fichero es alargado, el contenido del fichero entre la posición anterior de EOF y la nueva no está definido.

Si se llama a CreateFileMapping para crear un objeto file-mapping para hFile, primero debe llamarse a UnmapViewOfFile para desproyectar todas las vistas y a CloseHandle para cerrar el objeto file-mapping antes de que se pueda llamar a SetEndOfFile.