Category Asynchronous mode, Object ProEngineer

Function ProEngineerStart


Description
Causes the Creo Parametric TOOLKIT program to spawn and connect to a new Creo Parametric session. It is intended for use in simple and full asynchronous modes.
Synopsis
#include <ProCore.h>
ProErrorProEngineerStart(
char* proe_path
/* (In)
The path and file name of the Creo Parametric executable, or a script that runs it. For Creo+ use string "creoplus.exe " and set environment variable TK_ASYNC_CREO_AUTO_LOCATE=true This will auto locate Creo+ if installed and spawn it. Pass --profile --cwd as args to automate launch of Creo+ Pass arguments to Creo using token ++creo_tk For example, "creoplus.exe --profile profile1 ++creo_tk -g:no_graphics -i:rpc_input" Above value will launch Creo+ with profile profile1 and Creo will receive arguments -g:no_graphics -i:rpc_input
*/
char* prodev_text_path
/* (In)
The path under which the Creo Parametric TOOLKIT message and menu files are held. This is used in full asynchronous mode only. Otherwise, pass a null string.
*/
)
Returns
PRO_TK_NO_ERRORCreo Parametric started successfully.
PRO_TK_GENERAL_ERRORThere was a general error.
PRO_TK_NO_LICENSECreo Parametric could not get a license to run.
PRO_TK_APP_NO_LICENSECreo Parametric was run without the licenses needed to run this application.
PRO_TK_INVALID_DIRprodev_text_path is not a valid directory.
otherError status returned by the application's user_initialize().

Special cases:

  • if the application is running in native mode instead of Unicode, PRO_TK_BAD_INPUTS may indicate that prodev_text_path could not be converted to or from Unicode.
  • PRO_TK_APP_CREO_BARRED indicates that proe_path pointed to a Creo application that does not support Creo Parametric TOOLKIT.

Manual References:

  1. Debugging Creo TOOLKIT Applications: Debugging an Asynchronous Spawn Mode Application
  2. Pro/DEVELOP to Creo Toolkit Function Mapping: Equivalent Pro/DEVELOP Functions
  3. Fundamentals: Creo Toolkit Support for Creo Applications
  4. Core: Asynchronous Mode: Simple Asynchronous Mode
  5. Core: Asynchronous Mode: Simple Asynchronous Mode
  6. Core: Asynchronous Mode: Setting Up a Non-Interactive Session

Sample Code References:

  1. pt_async ( TestAsync.c )
  2. pt_async ( TestAsync.c )
  3. pt_simple_async ( simple_async.c )