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 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:

CNVBrowseTypeUndefinedThe item's browse type is not defined.
CNVBrowseTypeMachineThe item is a computer.
CNVBrowseTypeProcessThis item is a process.
CNVBrowseTypeFolderThe item is a folder.
CNVBrowseTypeItemThe item is a variable.
CNVBrowseTypeItemRangeThe item is a range of variables. You can connect to only one of the variables in the range.
CNVBrowseTypeImplicitItemThe item is an implict item. To connect to this item, specify the pathname of its parent.
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

WAS THIS ARTICLE HELPFUL?

Not Helpful