Category Creo Parametric fundamentals, Object ProMdl

Function ProMdlFiletypeLoad


Description
Retrieves the specified model and initializes the handle.

The function retrieves the model into memory, but neither displays the model nor makes it the current model. Differs from ProMdlnameRetrieve in that the caller can specify the location of the model in addition to its name.

If retrieving an assembly, and errors occur in regeneration, the assembly will include suppressed features. The function ProSolidRetrievalErrorsGet identifies if errors occurred.

Synopsis
#include <ProMdl.h>
ProErrorProMdlFiletypeLoad(
ProPath full_path
/* (In)
The full path of the model to be retrieved, including the name, and optionally the location and extension.
*/
ProMdlfileType type
/* (In)
The type of the model to retrieve, or PRO_MDLFILE_UNUSED if full_path includes an extension.
*/
ProBoolean ask_user_about_reps
/* (In)
If TRUE, the Open Rep dialog may be presented, allowing the user to specify which simplified representation of the model should be retrieved.
*/
ProMdl* p_handle
/* (Out)
The handle to the retrieved model
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully retrieved the model.
PRO_TK_BAD_INPUTSOne or more of the input arguments are invalid.
PRO_TK_CANT_OPENThe model exists but is not readable.
PRO_TK_E_NOT_FOUNDThe model does not exist, or was not found
PRO_TK_INVALID_FILEThe model is not a Creo Parametric model.
PRO_TK_INVALID_NAMEThe model name is too long.
PRO_TK_NO_PERMISSIONThe function does not have permission to operate on this model.
PRO_TK_BAD_CONTEXTThe Multi-CAD model is not being retrieved from an active Windchill server.
PRO_TK_GENERAL_ERRORThe model could not be retrieved.
See Also
ProSolidRetrievalErrorsGet

Manual References:

  1. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  2. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  3. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  4. Data Management: Windchill Operations: Retrieval

Sample Code References:

  1. pt_examples ( TestDbms.c )
  2. pt_userguide ( UgSmtFlatWallCreate.c )
  3. pt_userguide ( UgSmtFlatWallCreate.c )
  4. pt_userguide ( UgSmtFlgWallCreate.c )