 |
PK_PARTITION_start_cloning |
|
PK_ERROR_code_t PK_PARTITION_start_cloning
(
--- received arguments ---
PK_PARTITION_t partition, --- partition
PK_PMARK_t from_pmark, --- from_pmark and
PK_PMARK_t to_pmark, --- to_pmark to define
--- the clone span
const PK_PARTITION_start_cloning_o_t *options --- options
)
This function starts cloning in the given 'partition'.
Note: You are advised to consult with Parasolid Support before using
cloning.
Specific Errors:
PK_ERROR_rollback_not_started Partitioned rollback is not active (MILD)
PK_ERROR_bad_user_field_size User fields are in use (MILD)
PK_ERROR_bad_mark 'from_pmark' or 'to_pmark' is
unsuitable (MILD)
PK_ERROR_not_at_pmark Partition is not at 'from_pmark' (MILD)
PK_ERROR_not_stopped Partition cloning already started (MILD)
PK_ERROR_frustrum_failure The frustrum returned an error (MILD)
PK_ERROR_bad_partition Partition not allowed to be cloned (MILD)
A clone span of pmarks in the 'partition' is defined and identified by
a 'from_pmark' and a 'to_pmark'. There must be a path from the
'from_pmark' to the 'to_pmark' in the 'partition's pmark graph which
only involves rolling forward. When a clone span is created the
'partition' must be at the `from pmark'. The 'from_pmark', 'to_pmark'
and all pmarks within the clone span are called "original" pmarks of
the clone span.
This function should only be called when partitioned rollback has been started
with PK_DELTA_register_callbacks.
Partitions which allow partial pmarks are not allowed to be cloned.