Download LabOne Programming Manual

6.2. Module Documentation
ziAPISubscribe
ZIResult_enum ziAPISubscribe ( ZIConnection conn, const char* path )
subscribes the nodes given by path for ziAPIPollDataEx
This function subscribes to nodes so that whenever the value of the node changes the new value
can be polled using ziAPIPollDataEx . By using wildcards or by using a path that is not a leaf node
but contains sub nodes, more than one leaf can be subscribed to with one function call.
Parameters:
[in]
conn
Pointer to the ziConnection for which to subscribe for
[in]
path
Path to the nodes to subscribe
Returns:
• ZI_SUCCESS on success
• ZI_CONNECTION when the connection is invalid (not connected) or when a communication
error occurred
• ZI_LENGTH if the Path's Length exceeds MAX_PATH_LEN
• ZI_OVERFLOW when a FIFO overflow occurred
• ZI_COMMAND on an incorrect answer of the server
• ZI_SERVER_INTERNAL if an internal error occurred in the Data Server
• ZI_NOTFOUND if the given path could not be resolved or no node given by path is able to hold
values
• ZI_TIMEOUT when communication timed out
See Data Handling for an example
See Also:
ziAPIUnSubscribe , ziAPIPollDataEx , ziAPIGetValueAsPollData
LabOne Programming Manual
Revision 31421
Zurich Instruments
194