pipt_tagpreferred

This function retrieves the long tagname for the passed point. If the long tagname is not defined for the point, the tagname with delimiters is returned. If the string is longer than the passed len, the tag string will be truncated.

Note: Starting with PI-API 1.4.0 this function has been deprecated in favor of  pipt_tagnamex,  which supports tag names greater than 80 characters long.

C format

int32 pipt_tagpreferred(

int32 pt,

char PIPTR * tagname,

int32 len );

Returns

>0

System error 

0

Success 

-1

Point does not exist 

-411

Tagname was truncated to fit buffer

Arguments

pt (passed)

Point number

tagname (returned)

Tagname buffer.

len (passed)

Length of the passed tagname buffer

Usage Notes

Enabling Operational Intelligence