IsValidItem

long IsValidItem (long PenHandle);

 

Available (from release):

 

stOCX (V4-0), stPro Automation (V4-0), stTabular History OCX (V4-01), stTabular History Automation (V4-01)

 

Return Value:

 

Value:

Description:

1

The pen is mapped to a valid OPC item.

0

The pen is mapped to an invalid OPC item.

-1

The state of the new item is unknown.

 

Tip:  User code should keep checking IsValidItem (with a pause in-between) until it is a definitive 0 or 1 since -1 is "I don't know yet".

 

Parameters:

 

Name:

Description:

PenHandle

The handle of the pen that is to be verified.

 

Remarks:

 

Call this function to see if the pen identified by the handle is valid.