typedef int  (*PK_UCOPWR_f_t)(const int  guise,    const int  format,
                              const PK_UCHAR_t name[],
                              const char pr2hdr[],
                                    int *strid);



  Open various guises of part file for writing

Receives:
  int                       guise          --- class of file:
                                           ---  FFCSNP,FFCXMT,
                                           ---  FFCXMP,FFCXMD
                                           ---  snapshot,C-transmit,
                                           ---  partition,delta
  int                       format         --- format code:
                                           ---  FFBNRY,FFTEXT,FFXML
                                           ---  (binary,text,XML)
  PK_UCHAR_t                name[]         --- key which identifies file
                                           ---  (null-terminated Unicode)
  char                      pr2hdr[]       --- part 2 header data from
                                           --- Parasolid (null terminated)

Returns:
  int                       strid          --- id for stream on which
                                           --- file is open

Return codes:               FR_no_errors
                            FR_bad_name
                            FR_already_exists
                            FR_open_fail
                            FR_write_fail
                            FR_disc_full


Description:
  This function opens various guises of new files for writing, i.e.
  C transmit, snapshot, partition and delta files, using a Unicode key.

  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.