Previous

Next

Function RTFSeekEx

RTFSeekEx repositions a file pointer and possibly extends a file:

typedef union _LARGE_INTEGER { 
    struct { 
        DWORD LowPart; 
        LONG  HighPart; 
    } u; 
    __int64 QuadPart; 
} LARGE_INTEGER; 

int RTFSeekEx(RTFHANDLE File, LARGE_INTEGER * Offset, int Whence);

Parameters

File

References the open file for which to reposition the file pointer.

Offset

Pointer to a 64-bit signed integer which specifies how far the file pointer should be moved.

Whence

Specifies *Offset's meaning. The following values are allowed:

return value

If the function succeeds, it returns RTF_NO_ERROR and *Offset receives the new file pointer relative to the beginning of the file. If the function fails, the return value is a negative error code.

Moving the file pointer before the beginning of the file is an error. However, moving it beyond the current file size is supported. In this case, the file is extended. The data between the previous file size and the new file size is undefined. This method to extend a file is much faster than actually writing data to it. An alternate method to extend a file is to use function RTFExtend.

General File I/O

Function RTFWrite

Function RTFSeek