Category Solids and parts, Object ProSolid

Function ProSolidExternChildrenGet


Description
Collect data on external children of the features of the specified solid according to the specified reference type.

Note:This function requires the Pro/ASSEMBLY module license. This functionality is only available in the Global Reference Viewer, available under that license.
Synopsis
#include <ProRefInfo.h>
ProErrorProSolidExternChildrenGet(
ProSolid solid
/* (In)
The handle to a solid to be checked.
*/
ProExtRefType child_type
/* (In)
The type of required references. PRO_ALL_REF_TYPES means both local and external references will be collected. PRO_LOC_GEOM_REF, PRO_LOC_REL_REF, PRO_FEAT_PAT_LOC_REF and PRO_LOC_MERGE_REF means only local references will be collected. The rest types causes only external references to be collected.
*/
ProExtRefInfo** r_child_infos
/* (Out)
Array of children found. Allocated inside function when any children are of child_type are found.
*/
int* n_infos
/* (Out)
Number of elements in r_child_infos.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully returned the information.
PRO_TK_BAD_INPUTSInvalid solid handler or invalid reference type, or r_child_infos is NULL, or n_infos is NULL.
PRO_TK_NOT_VALIDRequired license not found.
PRO_TK_E_NOT_FOUNDNo children of child_type are found.
PRO_TK_E_IN_USE(*r_infos) is not NULL.
PRO_TK_OUT_OF_MEMORYThere are too many references in model to fit them into an array. Some references will be excluded.
PRO_TK_GENERAL_ERRORThe operation failed.

Manual References:

  1. Assembly: Top-down Design: External Reference Data Gathering
  2. Assembly: Top-down Design: External Reference Data Gathering

Sample Code References:

  1. pt_examples ( TestExtrefInfo.c )