Category Creo Parametric fundamentals, Object ProMdl

Function ProMdlRepresentationFiletypeLoad


Description
Retrieves the specified simplified representation of an assembly.

NOTE:

The function ProSolidRetrievalErrorsGet identifies errors if occurred.
Synopsis
#include <ProMdl.h>
ProErrorProMdlRepresentationFiletypeLoad(
ProPath assembly_file
/* (In)
The assembly file location. Cannot be NULL. May include: generic name, instance name, file extension, file version, absolute or relative path to a local folder or a url. Example: wtpub://asm_1.asm.3 Example: just gen_asm_1 (will look for a file in the current dirrectory; in this case the type must be passed in).
*/
ProMdlfileType type
/* (In)
Model type. May be PRO_MDLFILE_UNUSED if assembly_file includes file extension
*/
ProName simprep_name
/* (In)
The name of the simplified representation. Must be NULL if not user-defined (if not NULL, it is considered to be user-defined).
*/
ProSimprepdata* p_simp_rep_data
/* (In)
The simplified representation data. Can be NULL for a user defined represenation. The instructions in the data will be used to create a new representation on the fly if such representation does not exist.
*/
ProMdl* result
/* (Out)
The handle to the model. Cannot be NULL.

Note: The function retrieves the model into memory, but neither displays the model nor makes it the current model. If during retrieving an assembly errors occur on regeneration then the assembly will include suppressed features.

Use ProSolidRetrievalErrorsGet to get the errors.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully retrieved the model.
PRO_TK_BAD_INPUTSOne or more of the input arguments are invalid
PRO_TK_E_NOT_FOUNDThe file was not found.
PRO_TK_CANT_OPENThe file exists but is not readable.
PRO_TK_EMPTYThe specified representation was not stored in the file (for non user-defined representations).
PRO_TK_INVALID_FILEThe model is not a Creo Parametric model.
PRO_TK_GENERAL_ERRORThe model could not be retrieved.
PRO_TK_LINE_TOO_LONGThe model name is too long.
PRO_TK_INVALID_NAMEThe specified user defined representation was not found (in which case it may be created
on the fly following instructions in p_simp_rep_datacheck p_result for being not NULL)
PRO_TK_NO_PERMISSIONThe function does not have permission to operate on this model.
See Also
ProSolidRetrievalErrorsGet

Manual References:

  1. Assembly: Simplified Representations: Retrieving Simplified Representations
  2. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  3. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  4. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions