 |
PK_THREAD_is_in_chain |
|
PK_ERROR_code_t PK_THREAD_is_in_chain
(
--- returned arguments ---
PK_THREAD_chain_type_t *const type,
int *const length,
int *const remaining
)
This function returns the type of chain running in the calling thread, along
with its link length and the maximum number of remaining functions in the
current chain link.
A chain is a set of multiple, contiguous Parasolid functions called from a
single application thread, which has the same application thread protection as
a single Parasolid function.
Chains can consist of a single link containing all functions or can be split
into multiple shorter links, each containing one or more functions.
If this thread is not in a chain, 'type' will be PK_THREAD_chain_none_c. If
this thread is in a chain, 'type' and 'length' will have the same values as
passed into PK_THREAD_chain_start. The value of 'remaining' will be 0 if
'length' is 0, or between 0 and 'length' - 1 otherwise. In the latter case,
if 'remaining' has a value of 0, the chain will split and begin a new link
before the next Parasolid function is called.