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_WEBFORM_ADDFORMVAR 3

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

Remarks

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

Example (Submit Post)

WebFormControl.Reset()
WebFormControl.AddFormVar("formvarname1", "formvarvalue1")
WebFormControl.AddFormVar("formvarname2", "formvarvalue2")
WebFormControl.Submit()

WebFormControl.Reset()
WebFormControl.FormVarCount = 2
WebFormControl.FormVarName(0) = "formvarname1"
WebFormControl.FormVarValue(0) = "formvarvalue1"
WebFormControl.FormVarName(1) = "formvarname2"
WebFormControl.FormVarValue(1) = "formvarvalue2"
WebFormControl.SubmitTo(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.)