Retrieves the next palette from file and stores it in the buffer palette.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
The palette buffer is assumed to be at least 768 bytes long. Successive calls to DFPgetpal retrieve the palettes in the sequence they are stored in the file.