PK_FFOPWR_f_t

typedef void (*PK_FFOPWR_f_t)
(
--- received arguments ---
const int *guise,
const int *format,
const char name[],
const int *namlen,
const char pr2hdr[],
const int *pr2len,
--- returned arguments ---
int *strid,
int *ifail
);

Used in:

PK_SESSION_ask_fru_o_t
PK_SESSION_frustrum_t
PK_SESSION_register_fru_o_t

  Open all guises of file (except rollback) for writing

Receives:
  int                      *guise          --- class of file:
                                           ---  FFCSNP,FFCJNL,FFCXMT,
                                           ---  FFCSCH,FFCLNC,FFCDBG
                                           ---  snapshot,journal,C-transmit,
                                           ---  schema,licence,debug report
  int                      *format         --- format code:
                                           ---  FFBNRY,FFTEXT,FFXML
                                           ---  (binary,text,XML)
  char                      name[]         --- key which identifies file
                                           ---  (terminator not required)
  int                      *namlen         --- length of name
  char                      pr2hdr[]       --- part 2 header data from
                                           --- Parasolid
                                           ---  (terminator not required)
  int                      *pr2len         --- length of part 2 header data

Returns:
  int                      *strid          --- id for stream on which
                                           --- file is open
  int                      *ifail          --- error code: FR_no_errors
                                           ---             FR_bad_name
                                           ---             FR_already_exists
                                           ---             FR_open_fail
                                           ---             FR_write_fail
                                           ---             FR_disc_full
                                           ---             FR_write_memory_full


Description:
  This function opens all guises of new files (except rollback) for
  writing, i.e. schema, C transmit, journal snapshot, licence files and
  debug report files.

  The 'pr2hdr' string contains a sequence of keyword names and values in the
  form KEYWORD1=value1;KEYWORD2=value2 etc. These describe the implementation
  of Parasolid, for storage in the file header. The characters in the keyword
  values do not need to be escaped when they are written to file.

  The routine returns a frustrum stream identifier or 'strid'.
  This is used in subsequent calls to FFWRIT and FFCLOS.