Respond

Respond

The Respond function generates a SIP response to the current request message with the supplied status code and reason phrase.

Syntax

bool Respond(
  string statusCode,
  string reasonPhrase,
  string appendHeader1,
  string appendHeader2,
   ...,
  string appendHeaderN
);

Parameters

• statusCode
  A SIP status code for the response, represented as a string (for example, "408").

• reasonPhrase
  A text message that describes the response reason (for example, "Server Not Available").

• appendHeader1
  The first new header to append to the message when responding. This parameter is optional.

• appendHeader2
  The second new header to append to the message when responding. This parameter is optional.

• ...
   

• appendHeaderN
  The last new header to append to the message when responding. This parameter is optional.

Return Values

Returns false if the current message is not a request (see the description of the sipRequest built-in variable in MSPL Built-in Variables), or if a non-1xx response has already been sent. Otherwise, it returns true.

Remarks

New headers are appended to the response by passing them in complete form as additional parameters to this function. For example, to add a "Contact" header to a response, the following call is correct:

Respond("200", "OK", "Contact=<someone@example.com>;param1=value1");

If the "=" (equals) is not present in the appended header or headers, a critical MSPL error is raised for each occurrence where it must be present.