Refnum to Session

Owning Palette: TestStand

Returns the underlying viSession handle from a LabVIEW IVI or VISA refnum. You can use the viSession handle in an environment other than LabVIEW. For the Refnum parameter of the Refnum to Session VI and the Session to Refnum VI, pass only a VISA or IVI refnum created using the LabVIEW VISA Open function or the IVI New Session function. Passing an invalid refnum or a refnum constant can lead to undefined behavior and is not supported.

Details

Refnum specifies the LabVIEW IVI or VISA refnum.
error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.
Session returns the underlying viSession handle for the Refnum parameter.
error out contains error information. This output provides standard error out functionality.

Details

In a TestStand sequence, you can use a VI to create a LabVIEW IVI or VISA refnum, use the Refnum to Session function to convert the refnum to a viSession handle, and store the viSession handle in a TestStand variable. You can use the viSession handle in VIs that subsequent steps in a sequence call. You must use the Session to Refnum function to convert the viSession handle back to a LabVIEW IVI or VISA refnum. Close the session when you no longer need the refnum.

You cannot use a viSession or a LabVIEW IVI or VISA refnum in a process other than the process in which you created it.