A3DPDFViewGetExternalName

A3DStatus A3DPDFViewGetExternalName(A3DPDFView *pView, A3DUTF8Char **ppcViewId)
A3DStatus A3DPDFViewGetExternalName(A3DPDFView* pView, A3DUTF8Char** ppcViewId)

Returns the identifier of the view.

The identifier may be used by JavaScript or PDF actions to activate a view. It can also be used to generate poster. The function returns a string.

Memory Management

In case of success, ppcViewId contains heap allocated memory you are responsible for. To free the memory on ppcViewId, call A3DPDFViewGetExternalName with pView set to 0.

Parameters

pView: The View object to work with. This object can be retrieved using the function A3DPDF3DArtworkGetViews()

ppcViewId: The identifier as a string.

Returns

A3D_SUCCESS in case of success or an error code