PK_PARTITION_receive_b

PK_ERROR_code_t                 PK_PARTITION_receive_b
(
--- received arguments ---
PK_MEMORY_block_t               block,
const PK_PARTITION_receive_o_t *options,     --- receive options

--- returned arguments ---
PK_PARTITION_t           *const partition    --- partition
)


This function receives a partition directly from application memory.


Specific Errors:
    PK_ERROR_rollback_not_started  Partitioned rollback is not active (MILD)
    PK_ERROR_schema_access_error   Error opening, closing, or reading the
                                   schema file (MILD)
    PK_ERROR_schema_corrupt        Contents of schema file not as expected
                                   (MILD)
    PK_ERROR_schema_incompatible   Schema contents in newer format (MILD)
    PK_ERROR_wrong_format          XT data does not have expected transmit
                                   format (MILD)
    PK_ERROR_wrong_version         XT data transmitted by incompatible version
                                   of modeller (MILD)
    PK_ERROR_wrong_version_delta   XT data transmitted by a version of the
                                   modeller that produces deltas incompatible
                                   with the current version (MILD)
    PK_ERROR_corrupt_file          Invalid transmit contents (MILD)
    PK_ERROR_file_read_corruption  Corrupt data read (MILD)
    PK_ERROR_size_mismatch         Transmitted parts created with different
                                   modeller resolution settings (MILD)
    PK_ERROR_attr_defn_mismatch    Transmitted attribute definitions do not
                                   match current ones (MILD)
    PK_ERROR_usfd_mismatch         XT data has incompatible user-field size
                                   (MILD)
    PK_ERROR_withdrawn_surface     Part contains a withdrawn blend surface
                                   (MILD)
    PK_ERROR_FG_receive_failure    Part contains irretrievable foreign
                                   geometry (MILD)
    PK_ERROR_deltas_not_available  The 'deltas_block' option is null when
                                   option 'receive_deltas' is not
                                   PK_PARTITION_rcv_deltas_no_c (MILD)
    PK_ERROR_facet_geometry        The partition contains facet geometry but
                                   facet geometry is not enabled in the session
                                   (MILD)
    PK_ERROR_mixed_geometry        A part contains mixed facet and classic
                                   geometry (MILD)
    PK_ERROR_lattice_geometry      The partition contains a lattice but facet
                                   geometry is not enabled in the session
                                   (MILD)


The transmit format option affects the format as follows:

    transmit format                format

    PK_transmit_format_text_c      FFTEXT
    PK_transmit_format_binary_c    FFBNRY
    PK_transmit_format_neutral_c   FFBNRY

Option PK_transmit_format_applio_c is not allowed.

If the 'receive_deltas' option is PK_PARTITION_rcv_deltas_no_c, the partition
will have only one (initial) pmark; if it is PK_PARTITION_rcv_deltas_later_c,
the partition will have two pmarks and will be 'at' the non-initial one; if it
is PK_PARTITION_rcv_deltas_yes_c, the partition will have all the pmarks with
which it was transmitted and will be 'at' the same pmark as when it was
transmitted.

If the option 'receive_deltas' is not PK_PARTITION_rcv_deltas_no_c, and
'receive_prev_version_deltas' is set to PK_LOGICAL_true, it is assumed that an
attempt to read deltas transmitted from an earlier version of Parasolid will
be made. In this case a check is made on the version of Parasolid used to
transmit the data. Where it is found to be from a version of Parasolid which
produces delta data incompatible with the current version, the error
PK_ERROR_wrong_version_delta will be returned.

When option 'receive_deltas' is not PK_PARTITION_rcv_deltas_no_c, and
'receive_prev_version_deltas' is set to PK_LOGICAL_false, PK_PARTITION_receive
will return PK_ERROR_wrong_version_delta if the file is not transmitted from
the same version of Parasolid.

The option 'receive_prev_version_deltas' is ignored when 'receive_deltas' is
PK_PARTITION_rcv_deltas_no_c.