Object ProMdlname

Function ProMdlnameBackup


Description
Makes a backup of an object in memory to a disk in a specified directory. This function is equivalent to the Creo Parametric command File, Backup.

You can pass NULL as the handle, in which case the backup_dir path must contain filename of object in session to be backed up.

If the backup_dir is empty, the backup of the object is made in the current directory. NOTE 1: The name of the file created is the same as the model. NOTE 2: If successful, future changes to the model will be saved to the backup directory. 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 longer names will be added in a future release.

Synopsis
#include <ProMdl.h>
ProErrorProMdlnameBackup(
ProMdl handle
/* (In)
The model to back up
*/
ProPath backup_dir
/* (In)
The backup path information
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully made a backup of the model.
PRO_TK_BAD_INPUTSOne or more of the input arguments are invalid.
PRO_TK_INVALID_PTRThe handle is not correct, or the name and type are invalid (for example, the object is not in memory).
PRO_TK_INVALID_TYPEThe specified type is invalid.
PRO_TK_CANT_WRITEThe system could not write to the specified directory.
PRO_TK_INVALID_DIRThe specified directory (path) is invalid.
PRO_TK_GENERAL_ERRORA general error occurred and the function failed.
PRO_TK_NO_PERMISSIONThe function does not have permission to operate on this model.
PRO_TK_BAD_CONTEXTThe function is not available in Design Test Mode.

Manual References:

  1. Pro/DEVELOP to Creo Toolkit Function Mapping: Equivalent Pro/DEVELOP Functions
  2. Core: Models and Model Items: File Management Operations
  3. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  4. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  5. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions
  6. Technical Summary of Changes for Creo 11.0.0.0: Updates to Error Types

Sample Code References:

  1. pt_examples ( TestDbms.c )