DTWAIN_SetSaveFileName

Top  Previous  Next

The DTWAIN_SetSaveFileName function sets the full path name of the file that will be saved on acquisition.  This function can only be used during the acquisition process.

 

DTWAIN_BOOL  DTWAIN_SetSaveFileName (

DTWAIN_SOURCE

Source,

LPCTSTR

lpFilename );

 

Parameters

Source

An open TWAIN Source.

 

lpFileName

NULL terminated string denoting the new file name.

 

 

Return Values

The return value is TRUE on success, FALSE otherwise.  For more information on an error, call DTWAIN_GetLastError.

 

Character specific version

ANSI version:

DTWAIN_SetSaveFileNameA

Unicode version:

DTWAIN_SetSaveFileNameW

 

Comments

The DTWAIN_SetSaveFileName sets the name of the file that will be saved when DTWAIN_AcquireFile or DTWAIN_AcquireFileEx is used.  This function can only be used during the acquisition process.

.

The notification that the DTWAIN_SetSaveFileName is most used for is DTWAIN_TN_FILENAMECHANGING.   See also DTWAIN_GetSaveFileName to retrieve the file name that will be used to save the file.

 

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize.

DTWAIN Source Selection Function