Declaration

Delphi (DLL)
function PromoImageOptionsDoAction( var ConfigFileOrData: PAnsiChar; Action: integer; WParam:DWORD): integer; register;

C/C++ (DLL)
SOPAD_API int SOPAD_PromoImageOptionsDoAction(char* ConfigFileOrData, long Action, long WParam);

ActiveX
HRESULT _stdcall PromoImageOptionsDoAction([in] long Action, [in] long WParam, [in, out] BSTR* ConfigFileOrData, [out, retval] long* Result);

Description

PromoImageOptionsDoAction uploads/downloads/removes the resource to/from the file system
WParam = 0 : ...
WParam = 1 : ...

Arguments

Action: integer;
e.g. ACTION_UPLOAD = 0
e.g. ACTION_DOWNLOAD = 1
e.g. ACTION_REMOVE = 2

WParam:DWORD
platz halter für weitere parameter (default = 0 )

BSTR* ConfigFileOrData
content of resource or file name ( reference to the host filesystem) - Will be stored on harddisc

Return value

PromoImageOptionsDoAction returns (SOPAD_ERROR_SUCCESS = 0) if it was possible to run the desired ACTION on the resource.
Otherwise the function returns the appropriate error code. You can get extended error code with the help of GetSOPadError call.

Possible error codes are listed below: Driver error codes

See also

DownloadPadResourceFileByName

GetPadResourceFileInfoByName

GetPadResourceFileList

PromoImageOptionsDoAction

PromoImageSetOptions

RemovePadResourceFileByName

RenamePadResourceFileName

Sample

//  Create PromoScreen Options
int promoImageSetOptionsStatus = SigDev.PromoImageSetOptions(1, 0, 5, 0, 0);
int promoImageSetOptionsStatus = SigDev.PromoImageSetOptions(2, 0, 10, 0, 0);
int promoImageSetOptionsStatus = SigDev.PromoImageSetOptions(3, 0, 10, 0, 0);
int promoImageSetOptionsStatus = SigDev.PromoImageSetOptions(4, 0, 20, 0, 0);
 
//	Send PromoScreen Options to the Device
int promoImageSetOptionsStatus = SigDev.PromoImageOptionsDoAction(0, 0, "");