AddFormVar Method

Adds a form variable and the corresponding value.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int AddFormVar(const char* lpszVarName, const char* lpszVarValue);

Unicode (Windows)
INT AddFormVar(LPCWSTR lpszVarName, LPCWSTR lpszVarValue);

- (void)addFormVar:(NSString*)varName :(NSString*)varValue;

#define MID_WEBUPLOAD_ADDFORMVAR 4

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_WebUpload_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Please refer to FormVars and FileVars for more information on form and file variables and how they are managed.

Example (Submit Post)

WebUploadControl.Reset()
WebUploadControl.AddFormVar("formvarname1", "formvarvalue1")
WebUploadControl.AddFileVar("filename1", "c:\filename1.txt")
WebUploadControl.Upload()

WebUploadControl.Reset()
WebUploadControl.FormVarCount = 1
WebUploadControl.FormVarName(0) = "formvarname1"
WebUploadControl.FormVarValue(0) = "formvarvalue1"
WebUploadControl.FileVarCount = 1
WebUploadControl.FileVarName(0) = "filename1"
WebUploadControl.FileVarValue(0) = "C:\filename1.txt"
WebUploadControl.UploadTo(url)

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)