PK_SESSION_ask_binding

PK_ERROR_code_t                 PK_SESSION_ask_binding
(
--- received arguments ---
PK_SESSION_binding_t            enquiry,

--- returned arguments ---
PK_SESSION_binding_t     *const answer
)


This function allows the application to identify the programming
language binding in use.

This function may be called at any time.


Specific Errors:
PK_ERROR_bad_value (mild)       The received argument is invalid.
PK_ERROR_not_implemented (mild) The binding in question is not implemented.


Programs that don't use the Parasolid binding for Microsoft .NET
programming do not need to use this function and can ignore it.

PK_SESSION_ask_binding allows an application to enquire of
Parasolid which programming language binding is in use. This
function is intended for use by the Parasolid testing systems;
it won't normally be needed by customer applications.

For the version of this function in the Parasolid library, if
'enquiry' is PK_SESSION_binding_unknown_c, then the 'answer'
value is PK_SESSION_binding_C_native_c. If 'enquiry' is any of
the other defined values of PK_SESSION_binding_t, the 'answer'
value will be the same as the 'enquiry' value: the function
assumes that the 'enquiry' value was set by a binding, when it
received the function call, before passing it on to this
function.

Each binding for Parasolid will have its own version of this
function. When that is called with an 'enquiry' of
PK_SESSION_binding_unknown_c, the function will will call the
Parasolid version of this function with an 'enquiry' value that
describes itself. The Parasolid version of the function will
then set that value as the 'answer' value.

Parasolid applications normally know which binding they were
written for and don't need to call this function. If an
application could use more than one binding and needs to know
which is in use in a session, then it should call this function
with PK_SESSION_binding_unknown_c, and use the 'answer' value.