If password is valid, this function creates a new IVI instrument driver session to the device specified in resourceName and returns an instrument handle you use to identify the device in all subsequent NI-DCPower function calls. This function also sends initialization commands to set the device to the state necessary for the operation of NI-DCPower.

Syntax

ViStatus _VI_FUNC niDCPower_InitExtCal(ViRsrc resourceName, ViConstString password, ViSession *vi)

Remarks

Opening a calibration session always performs a reset. Refer to the calibration procedure for the device you are calibrating for detailed instructions on the appropriate use of this function.

Note

This function and the sessions is creates do not support fully qualified channel names.

Parameters

NameDirectionTypeDescription
resourceName[in]ViRsrc

Specifies the resourceName assigned by Measurement & Automation Explorer (MAX), for example "PXI1Slot3" where "PXI1Slot3" is an instrument's resourceName. resourceName can also accept a logical IVI name for a device.

password[in]ViConstString

Specifies the password for opening a calibration session. The initial password is factory configured to "NI". password can be a maximum of four alphanumeric characters.

vi[out]ViSession *

Returns a handle that you use to identify the session in all subsequent NI-DCPower function calls.

Returns

Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors