viFindNext

NI-VISA

viFindNext

Purpose

Returns the next resource from the list of resources found during a previous call to viFindRsrc().

C Syntax

ViStatus viFindNext(ViFindList findList, ViChar instrDesc[])

Visual Basic Syntax

viFindNext&(ByVal findList&, ByVal instrDesc$)

Resource Classes

VISA Resource Manager

Parameters

Name Direction Description

findList

IN

Describes a find list. This parameter must be created by viFindRsrc().

instrDesc

OUT

Returns a string identifying the location of a device. Strings can then be passed to viOpen() to establish a session to the given device.

Return Values

Completion Codes Description

VI_SUCCESS

Resource(s) found.

 

Error Codes Description

VI_ERROR_INV_OBJECT

The given object reference is invalid.

VI_ERROR_NSUP_OPER

The given findList does not support this operation.

VI_ERROR_RSRC_NFOUND

There are no more matches.

Description

The viFindNext() operation returns the next device found in the list created by viFindRsrc(). The list is referenced by the handle that was returned by viFindRsrc().

Note  The size of the instrDesc parameter should be at least 256 bytes.

Related Topics

viFindRsrc

VISA Resource Template