NI System Configuration API Reference

Content Type
Programming Language
Current manual

Find Hardware (VI)

Find Hardware (VI)

Installed With: NI System Configuration

Returns a list of hardware in a specified system using the system's session refnum.

Find Hardware

ci32.gif

Filter Mode specifies an enumerated list of filter modes. Filter Mode is ignored if Filter in is not wired.

all values match (1)

(default) includes all of the properties specified in the input filter.

any value matches (2)

includes any of the properties specified in the input filter.

values do not match (3)

includes none of the properties specified in the input filter.

all properties exist (4)

includes all of the properties specified in the input filter, regardless of the value of each property.

cio.gif

Session in specifies the system being initialized.

crn.gif

Filter in specifies a user-defined refnum of system filter instance. The filter is used to limit the results to hardware matching specific properties. The default is no filter. Use the Create Filter VI and Filter Property Node to configure a new filter.

cstr.gif

Experts specifies a case-insensitive comma-separated string specifying which experts to query. If Experts is unwired or blank, this VI queries all supported experts. The list of supported experts for a given system is returned from the Get System Experts VI.

Note  

Examples of expert names include daqmx and ni-visa . For a listing of the available experts for this operation and the input strings to use, refer to KnowledgeBase article 5FFA2JBP .

cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

cu32.gif

Remote Timeout specifies the time in milliseconds that this VI waits before it times out. The default amount of time that the VI waits for a response on the network before timing out is 5 minutes. In some cases, the operation may take longer to complete. This timeout is for remote systems only.

iio.gif

Session out returns the refnum for the system.

irn.gif

Filter out returns the user-defined refnum for the system filter instance.

i1drn.gif

Resources out returns an array of references to hardware in the system. Call the Close (Hardware) VI on each reference when you no longer need it.

Note  

This parameter may return some devices that were recently online even if they are no longer present. To determine if the device is present, you can use the Hardware Property Node to return the Devices & Chassis:Is Present property or make other application specific API calls.

ierrcodeclst.gif

error out returns error information. This output provides standard error out functionality.

Was this information helpful?