AddFormVar Method

Adds a form variable and the corresponding value.

Syntax

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()
Example (Submit Post using FormVar Arrays)
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.)

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 C++ Edition - Version 20.0 [Build 8161]