Object ProMdlname

Function ProMdlnameRetrieve


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.

If retrieving an assembly, and errors occur in regeneration, the assembly 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 ProFamilyMdlName will be added in a future release.
Replacement in Object TOOLKIT: wfcWSession::OpenSource
wfcWSession::RetrieveModelByFiletype
Synopsis
#include <ProMdl.h>
ProErrorProMdlnameRetrieve(
ProFamilyMdlName name
/* (In)
The name of the model to retrieve
*/
ProMdlfileType type
/* (In)
The type of the model to retrieve
*/
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_E_NOT_FOUNDThe model was not found in the current directory.
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.
See Also
ProSolidRetrievalErrorsGet

Manual References:

  1. Pro/DEVELOP to Creo Toolkit Function Mapping: Equivalent Pro/DEVELOP Functions
  2. Assembly: Basic Assembly Access: Automatic Interchange
  3. Assembly: Data Sharing Features: Variant Feature Model
  4. Core: Models and Model Items: File Management Operations
  5. Core: Models and Model Items: File Management Operations
  6. Element Trees: Sections: Retrieving and Saving a Section
  7. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  8. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  9. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  10. Data Management: Windchill Operations: Retrieval
  11. Data Management: Windchill Operations: Retrieval
  12. Data Management: Windchill Operations: Sample Batch Workflow

Sample Code References:

  1. pt_async ( TestAsync.c )
  2. pt_async ( TestAsync.c )
  3. pt_examples ( TestAsm.c )
  4. pt_examples ( TestMultiCADFile.c )
  5. pt_examples ( TestSkelet.c )
  6. pt_examples ( TestDbms.c )
  7. pt_examples ( TestDbms.c )
  8. pt_examples ( TestDrwSheets.c )
  9. pt_examples ( TestDrwView.c )
  10. pt_examples ( TestDrawing.c )
  11. pt_examples ( TestDrawing.c )
  12. pt_examples ( TestTool.c )
  13. pt_examples ( UtilSect.c )
  14. pt_examples ( UtilTree.c )
  15. pt_userguide ( UgAsmcompConstraint.c )
  16. pt_userguide ( UgDrawingViews.c )
  17. pt_userguide ( UgModelAdd.c )
  18. pt_userguide ( UgModelDelete.c )
  19. pt_userguide ( UgMfgSldToolCreate.c )
  20. pt_userguide ( UgSolidLoadDisp.c )