Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual - Manual (Page 252)

API Library of Routines
Appendix B
TAG_LINK
B-121
Gets the handle from TAG name.
C Syntax
#include <copro.h>
unsigned TAG_LINK (name_id,tag_name)
unsigned *name_id;
unsigned char *tag_name;
Parameters
name_id
Name_id is used to return a handle assigned by the TAG library to the
TAG name.
tag_name
Specifies the name of the user’s TAG. This is a null-terminated
ASCII string of up to 9 characters. The TAG name can contain the
following characters: A-Z, a-z, 0-9, and _. The first character
must be alphabetic.
Returns
Value Symbolic Name Meaning
0 CC_SUCCESS Operation successful
176 CC_E_NOTAG TAG not found
Description
Use the TAG_LINK function to get a TAG handle for a TAG-table entry.
This handle is an offset into the TAG table. It makes subsequent access to
the table faster than doing a symbolic name search.
TAG_LINK