Category Creo Parametric fundamentals, Object ProMdl

Function ProMdlLoad


DEPRECATED: Since Creo 3
SUPERSEDED BY: ProMdlFiletypeLoad
Description
Note: This function is deprecated Use ProMdlFiletypeLoad instead. 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 ProMdlRetrieve 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.

Replacement in Object TOOLKIT: pfcBaseSession::RetrieveModelWithOpts
Synopsis
#include <ProMdl.h>
ProErrorProMdlLoad(
ProPath full_path
/* (In)
The full path of the model to be retrieved, including the name, and optionally the location and extension.
*/
ProMdlType type
/* (In)
The type of the model to retrieve, or PRO_MDL_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_GENERAL_ERRORThe model could not be retrieved.
See Also
ProSolidRetrievalErrorsGet

Manual References:

  1. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  2. Technical Summary of Changes for Creo 4.0 F000: Model