PK_PART_receive_version_u

PK_ERROR_code_t                    PK_PART_receive_version_u
(
--- received arguments ---
const PK_UCHAR_t                  *key,             --- key string
PK_transmit_format_t               transmit_format, --- file format

--- returned arguments ---
PK_SESSION_kernel_version_t *const version          --- version
)


This function returns information about the version of Parasolid used to create
a part transmit file.


Specific Errors:
    PK_ERROR_corrupt_file          file header not as expected (MILD)
    PK_ERROR_bad_filename          invalid filename (MILD)
    PK_ERROR_cant_find_file        cannot find file (MILD)
    PK_ERROR_cant_open_file        cannot open file (MILD)
    PK_ERROR_file_access_error     unexpected file access error (MILD)
    PK_ERROR_applio_not_registered application i/o functions not registered
                                     (MILD)
    PK_ERROR_schema_access_error   file referred to non-existent schema (MILD)
    PK_ERROR_file_read_corruption  corrupt data read. Perhaps an NFS problem
                                     (MILD)


Before this function can be used, it must be enabled by calls to
PK_SESSION_set_unicode and then PK_SESSION_register_frustrum and/or
PK_SESSION_register_applio.

Currently only the 'major_revision', 'minor_revision' and 'build_number'
fields of the returned PK_SESSION_kernel_version_t structure are
meaningful.  All other fields are set to zero.  This information shows
exactly which build of Parasolid was used to create the part transmit
file with the given Unicode key.

If the file was transmitted using the 'transmit_version' option of
PK_PART_transmit, this function will return the 'major_revision' and
'minor_revision' that were being impersonated at that time.  The
'build_number' will not be significant.

If 'key' refers to a FORTRAN transmit file, then 'major_revision'
will be set to zero.  Only V5.4 and V6.0 FORTRAN transmit files are
recognized by this function.  Other versions will lead to
PK_ERROR_corrupt_file.
For V5.4, 'minor_revision' is set to 5 and 'build_number' to 4.
For V6.0, 'minor_revision' is set to 6 and 'build_number' to 0.
Note that while this function can recognize V5.4 FORTRAN transmit files,
PK_PART_receive_u itself can only receive V6.0 FORTRAN transmit files.

The 'transmit_format' value of PK_transmit_format_indexio_c is not allowed.