DAQmxSaveTask

NI-DAQmx C Functions

previous page next page

DAQmxSaveTask

int32 DAQmxSaveTask (TaskHandle taskHandle, const char saveAs[], const char author[], uInt32 options);

Purpose

Saves the specified task and any local channels it contains to MAX. This function does not save global channels. Use DAQmxSaveGlobalChan to save global channels.

Programmatically saved tasks cannot be viewed in the DAQ Assistant for versions of NI-DAQ earlier than 7.4. To view a programmatically saved task in an earlier version of NI-DAQ, first use the DAQ Assistant in NI-DAQ 7.4 or later to save the task.

Visit the DAQmx Professional Developer Tools website for more information and examples of programmatically saving global channels.

Parameters

Input

Name

Type

Description

taskHandle

TaskHandle

The task to save.

saveAs

const char []

Name to save the task as. If you pass an empty string ("") or NULL, the name currently assigned to the task will be used.

author

const char []

Name to store with the task.

options

uInt32

Use this parameter to set certain options. You can combine options with the bitwise-OR operator ('|') to set multiple options. Pass a value of zero if no options need to be set.

Value		Description
DAQmx_Val_Save_Overwrite		Overwrite a task of the same name if one is already saved in MAX. If you do not set this flag and a task of the same name is already saved in MAX, the function returns an error.
DAQmx_Val_Save_AllowInteractiveEditing		Allow the task to be edited in the DAQ Assistant. If you set this flag, the DAQ Assistant must support all task settings.
DAQmx_Val_Save_AllowInteractiveDeletion		Allow the task to be deleted through MAX.

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

previous page start next page