AddParam Method

Adds a parameter-value pair.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int AddParam(const char* lpszParamName, const char* lpszParamValue);

Unicode (Windows)
INT AddParam(LPCWSTR lpszParamName, LPCWSTR lpszParamValue);

- (void)addParam:(NSString*)paramName :(NSString*)paramValue;

#define MID_SOAP_ADDPARAM 4

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

Remarks

Please refer to the parameter name and value provided in the Params properties for more information on SOAP parameters and how they are managed.

Example (Send SOAP Request)

SOAPControl.Reset()
SOAPControl.AddParam("paramname", "paramvalue")
SOAPControl.AddParam("paramname", "paramvalue")
SOAPControl.MethodURI = "methoduri"
SOAPControl.Method = "methodname"
SOAPControl.URL = "endpointURL"
SOAPControl.SendRequest()

SOAPControl.Reset()
SOAPControl.ParamCount = 2
SOAPControl.ParamName(0) = "paramname"
SOAPControl.ParamValue(0) = "paramvalue"
SOAPControl.ParamName(1) = "paramname2"
SOAPControl.ParamValue(1) = "paramvalue2"
SOAPControl.ParamAttrs(1) = "customattr=value"
SOAPControl.MethodURI = "methoduri"
SOAPControl.Method = "methodname"
SOAPControl.URL = "endpointURL"
SOAPControl.SendRequest()

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.)