HM_ExtAPI::CADDocumentGetName()

Returns the name of the model assembly hierarchy document.

Syntax

const char* CADDocumentGetName(
const HM_CAD_Document & doc
);

Type

HyperMesh Ext API

Description

The string that is returned from the function HM_ExtAPI::CADDocumentGetName() should be copied for further use.

If the function succeeds, the return value is the pointer to zero terminated string that contains the name of the document. The return value can also be NULL. This usually means that the document doc is the root document in the assembly hierarchy, or that assembly hierarchy is not supported by the CAD translator used for loading the model.

Do not attempt to free the returned pointer.

The name of the document is assembly context independent name. This name is normally saved in the part file.

Requires including hm_extapi.h.

Inputs

doc: [in] - Handle to document object that was returned by previous calls to API functions.
Figure 1.

Errors

None.