viFindNext
Syntax
viFindNext(ViFindList findList, ViPRsrc instrDesc);
Description
This function returns the next resource found in the list created by viFindRsrc. The list is referenced by the handle that was returned by viFindRsrc.
|
Some Connection Expert settings and Keysight Instrument Discovery Service policies affect the operation of viFindRsrc, viFindNext, and viOpen. Click here for more information on these interactions. |
Parameters
|
Name |
Dir |
Type |
Description |
|---|---|---|---|
|
findList |
IN |
ViFindList |
Describes a find list. This parameter must be created by viFindRsrc. |
|
instrDesc |
OUT |
ViPRsrc |
Returns a string identifying location of a device. Strings can be passed to viOpen to establish a session to the device. |
Return Values
|
Type ViStatus |
This is the function return status. It returns either a completion code or an error code as follows. |
|
Completion Code |
Description |
|---|---|
|
VI_SUCCESS |
Resource(s) found. |
|
Error Code |
Description |
|
VI_ERROR_INV_SESSION |
The given session or object reference is invalid (both are the same value). |
|
VI_ERROR_NSUP_OPER |
The given findList does not support this function. |
|
VI_ERROR_RSRC_NFOUND |
There are no more matches. |