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.
Note: If you use the Agilent Connection Expert to put a resource into the ignored state, viFindRsrc and viFindNext will not find that resource. If an interface is in the ignored state, viFindRsrc and viFindNext will find neither the interface nor instruments on that interface.
Connection Expert's Address check property on an instrument also affects the operation of viFindRsrc and viFindNext for that instrument. Click here for more information on this interaction.
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 Codes |
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. |
See Also
viFindRsrc
Address Check, viFindRsrc, and viOpen