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.
*/
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. Pro/DEVELOP to Creo Parametric TOOLKIT Function Mapping: Equivalent Pro/DEVELOP Functions
  2. Debugging Creo Parametric TOOLKIT Applications: Debugging an Asynchronous Spawn Mode Application
  3. Technical Summary of Changes for Creo 4.0 F000: Creo Parametric TOOLKIT Support for Creo Applications
  4. Fundamentals: Creo Parametric TOOLKIT Support for Creo Applications
  5. Core: Asynchronous Mode: Starting and Stopping Creo Parametric
  6. Core: Asynchronous Mode: Starting and Stopping Creo Parametric
  7. 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 )