CNVBrowseNextItem
int CNVBrowseNextItem (CNVBrowser browser, char **item, int *leaf, CNVBrowseType *browseType, CNVData *typeData);
Purpose
Gets the next item in the network variable browser. This function returns the name, browse type, and data type of the item and indicates whether the item is a leaf, or terminal node.
 |
Note To avoid deadlocks, do not call this function in a network variable callback function. |
Parameters
| Input | ||||||||||||||||
| Name | Type | Description | ||||||||||||||
| browser | CNVBrowser | The handle that identifies the network variable browser. | ||||||||||||||
| Output | ||||||||||||||||
| Name | Type | Description | ||||||||||||||
| item | char * | The name of the browsed network variable item. You must free the memory for this string using CNVFreeMemory. | ||||||||||||||
| leaf | int | Indicates whether the browsed item is a leaf, or terminal node. If the item is not a leaf, then it can contain other items. | ||||||||||||||
| browseType | CNVBrowseType | The browse type of the item. You can pass NULL if you do not want this information. The following list describes the browse types:
|
||||||||||||||
| typeData | CNVData | Data representing the type of the browsed network variable item. You can pass NULL if you do not want this information. The Network Variable Library sets this value to NULL if it cannot obtain the type or if the type is not supported. | ||||||||||||||
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. One indicates that a next item was found, zero indicates that a next item was not found, and a negative number indicates that an error occurred. You can call CNVGetErrorDescription to obtain a string that describes the error. |
Additional Information
Library: Network Variable Library
Include file: cvinetv.h
LabWindows/CVI compatibility: LabWindows/CVI 8.1 and later