Category 3D interface, Object ProATB

Function ProATBMdlnameVerify


Description
To Verify if the ATB models are out of date. This function will first check to see if the model specified is a TIM (of some master model). If model is not a TIM, it will check to see if the model contains one or more features which are TIM representations of some model from ICEM. 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 ProMdlFileName will be added in a future release.
Replacement in Object TOOLKIT: wfcWModel::VerifyATB
Synopsis
#include <ProATB.h>
ProErrorProATBMdlnameVerify(
ProMdl model
/* (In)
Creo Parametric Part or Assembly that is a) A TIM representation of a model imported from the ATB interface such as CADDS/CATIA b) A Creo Parametric Assembly containing one or more components which are model imported from an ATB Interface such as CADDS/CATIA c) A Creo Parametric Part containing an Import Feature that is imported from an ATB Interface such as ICEM.
*/
int* feat_ids
/* (In)
ProArray of feature id(s). Indicates one or more ATB-Enabled feature(s) in the model. In that case, the ATB Verify operation will only work on the Feature(s) specified. If NULL, then the function will attempt to verify the entire model (TIM from CADDS/CATIA).
*/
ProPath* search_paths
/* (In)
ProArray of ProPath(s) indicating the set of additional directories to be searched for the master model. If NULL, then the function will search in current working directory or locations set in config-option atb_search_path.
*/
ProMdlFileName** models_out_of_date
/* (Out)
ProArray of ProMdlFileName(s) to represent the set of models out of date, which can be relinked. This maps to the models that show up as RED in the UI. Pass NULL if not interested. Free this argument using ProArrayFree.
*/
ProMdlFileName** models_unlinked
/* (Out)
ProArray of ProMdlFileName(s) to represent the set of unlinked models. This maps to the models that show up as YELLOW in the UI (with the broken link). Pass NULL if not interested. Free this argument using ProArrayFree.
*/
ProMdlFileName** models_old_version
/* (Out)
ProArray of ProMdlFileName(s) to represent the set of models of older version. This maps to the models that show up as YELLOW in the UI (with the broken link). Pass NULL if not interested. Free this argument using ProArrayFree.
*/
)
Returns
PRO_TK_NO_CHANGEThe function successfully verified the model and didn't find any ATB models out of date nor any models of old version nor any models with broken link.
PRO_TK_NO_ERRORThe function successfully verified the model and found ONE or more models out of date.
PRO_TK_NOT_VALIDThe function successfully verified the model, found ONE or more models of older version and found no ATB models out of date.
PRO_TK_BAD_CONTEXTThe function successfully verified the model, found ONE or more models with broken link and found no ATB models out of date and no ATB models of older version
PRO_TK_BAD_INPUTSThe function could not execute, since one or more REQUIRED inputs were missing or incorrect.
PRO_TK_UNSUPPORTEDThe input model is Multi-CAD model.

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. Interface: Importing Features: Associative Topology Bus Enabled Models and Features
  5. Interface: Importing Features: Associative Topology Bus Enabled Models and Features