Respond(string,string,string,string,,string) function

Microsoft Office Live Communications Server 2005 with SP1

Respond

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

boolRespond(stringstatusCode,
stringreasonPhrase,
stringappendHeader1,
stringappendHeader2,
...,
stringappendHeaderN);

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.

What did you think of this topic?
© 2008 Microsoft Corporation. All rights reserved.