niDCPower_ExportAttributeConfigurationFile
- Updated2023-04-15
- 2 minute(s) read
ViStatus niDCPower_ExportAttributeConfigurationFile(ViSession vi, ViConstString filePath);
Purpose
Exports a session configuration to the specified file.
You can export and import supported configurations only between NI‑DCPower devices with identical model numbers and the same number of configured channels.
This function verifies that the attributes you have configured for the session are valid. If the configuration is invalid, NI‑DCPower returns an error.
Supported Configurations
You can export and import the following configurations between NI‑DCPower sessions:
- Attribute configurations
- Advanced sequences
Support for this Function
You must set the source mode to NIDCPOWER_VAL_SEQUENCE in order to configure or export and import advanced sequences.
Configuration exports from sessions created with the niDCPower_InitializeWithIndependentChannels function cannot be imported into sessions created with deprecated initialize functions.
 |
Note Exporting and importing simple sequences in Sequence source mode is unsupported. |
Channel Mapping Behavior
When importing and exporting session attribute configurations between NI‑DCPower sessions that were initialized with different channels, the configurations of the exporting channels are mapped to the importing channels based on the order of the resources you specify in the resourceName input to the niDCPower_InitializeWithIndependentChannels function.
Refer to Import/Export Attribute Configuration Mapping Behavior for details.
Related Topics:
Using Properties and Attributes
Setting Properties and Attributes Before Reading Them
Parameters
| Input | ||
| Name | Type | Description |
| vi | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| filePath | ViConstString | The absolute path to a placeholder file you must create to contain the configuration you want to export. If you specify an empty or relative path, this function returns an error. Default file extension: .nidcpowerconfig |
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function. |