pilg_getselectedtag

This function returns information about the current selected tags by the application. The selection of tags is done via the tag search dialog.

C format

PIINT32 pilg_getselectedtag(

LPTAGLIST lpcTagList,

int32 lSeq)

Returns

>1

System error

1

Passed end of tag list. No more selected tags to return. No tag information is returned with this call.

0

Success

-1

GETNEXT was requested without GETFIRST being issued or GETNEXT called after a return of 1.

-103

Application is not registered

-106

No servers configured (pilogin.ini not found)

Arguments

lpcTagList (returned)

Pointer to the tag list structure allocated by the caller in which the tag information is returned.

lSeq (passed)

Sequence identifier: GETFIRST(0),GETNEXT(1).

Usage Notes

If in between calls to pilg_getselectedtag the selection of the tags changes the function will return ERR_GET_FIRST_NOT_ISSUED. The LPTAGLIST data type is defined in PILOGEX.H as follows:

typedef struct _taglist

{

char m_szServer [MAX_NODENAME_LEN]; 

int32 m_lNodeId;  

char m_szTagName[MAX_TAGNAME_LEN]; 

int32 m_lPoint; 

struct _taglist PIPTR* m_next; 

} TAGLIST, *PTAGLIST, PIPTR* LPTAGLIST;

Enabling Operational Intelligence