PK_UCOPWR_f_t

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

Used in:

PK_SESSION_ask_fru_o_t
PK_SESSION_frustrum_t
PK_SESSION_register_fru_o_t

  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
                            FR_write_memory_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.