restReqPostSet (Function)

This function will set the value of a post parameter in a request.

If the request contains post parameters, it can not also contain a normal body, as set with restReqBodySetJSON or restReqBodySetString.

Input:

req : SYSHANDLE

A handle to the request.

name : STRING

The name of the post parameter to set.

value : STRING

The new value of the parameter.

Returns: INT

Declaration:

FUNCTION restReqPostSet: INT;
VAR_INPUT
  req            : SYSHANDLE;
  name           : STRING;
  value          : STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM example;
VAR
  rc        : INT;
  req       : SYSHANDLE;
END_VAR
BEGIN
  ...
 
  // Set post parameter "post1" to "Value"
  rc := restReqPostSet(req:=req, name:="post1", value:="Value");
  DebugFmt(message:="restReqPostSet: \1", v1:=rc);
  ...
END;
END_PROGRAM;