Category View manager, Object ProSimprep

Function ProSimprepMdlnameRetrieve


Description
Retrieves the specified simplified representation. If a higher representation of the model exists in the memory, then the simplified representation of type rep_type will be ignored and the higher representation of the model will be retrieved.

NOTE:

If errors occur in regeneration, the model will include suppressed features. The function ProSolidRetrievalErrorsGet identifies if errors occurred. Note: In Creo 3 this function does not support names longer than 80 characters. It will return PRO_TK_BAD_INPUTS for longer names. The support for ProMdlName will be added in a future release.
Replacement in Object TOOLKIT: pfcBaseSession::RetrieveGraphicsSimpRep
pfcBaseSession::RetrieveSymbolicSimpRep
pfcBaseSession::RetrieveGeomSimpRep
pfcBaseSession::RetrievePartSimpRep
wfcWSession::RetrieveLightweightGraphicsSimpRep
wfcWSession::RetrieveDefaultEnvelopeSimprep
wfcWSession::RetrieveSimpRep
Synopsis
#include <ProSimprep.h>
ProErrorProSimprepMdlnameRetrieve(
ProMdlName model_name
/* (In)
The name of the model to retrieve. NULL is not allowed.
*/
ProMdlfileType file_type
/* (In)
The file type of the model to retrieve.
*/
ProSimprepType rep_type
/* (In)
The representation type. PRO_SIMPREP_MASTER_REP and PRO_SIMPREP_USER_DEFINED can be used only if file_type is PRO_MDLFILE_PART
*/
ProName rep_name
/* (In)
The name of the simplified representation, if the rep_type is PRO_SIMPREP_USER_DEFINED. Otherwise, this can be NULL.
*/
ProSolid* p_solid
/* (Out)
The handle to the model. NULL is allowed.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully retrieved the information.
PRO_TK_BAD_INPUTSOne or more of the input arguments are invalid.
PRO_TK_NO_PERMISSIONThe function does not have permission to operate on this model.
PRO_TK_INVALID_NAMEThe specified user defined rep was not found.
See Also
ProSolidRetrievalErrorsGet

Manual References:

  1. Assembly: Simplified Representations: Retrieving Simplified Representations
  2. Assembly: Simplified Representations: Retrieving Simplified Representations
  3. Assembly: Simplified Representations: Retrieving and Expanding LightWeight Graphics Simplified Representations
  4. Assembly: Simplified Representations: Retrieving and Expanding LightWeight Graphics Simplified Representations
  5. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  6. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  7. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  8. Technical Summary of Changes for Creo 11.0.0.0: Updates to Error Types

Sample Code References:

  1. pt_examples ( TestSimpRep.c )
  2. pt_examples ( TestSimpRep.c )