SetParameterValue(string or StandardHeader value,string,string) function

Microsoft Office Live Communications Server 2005 with SP1

SetParameterValue

The SetParameterValue function adds or sets a specific parameter value in a SIP header.

bool SetParameterValue(
  string or StandardHeader value headerName,
  string parameterName,
  string value
);

Parameters

• headerName
  The name of the header where the parameter will be added. For example, SetParameterValue("Contact", "param1", "value1") sets a parameter on the "Contact" header.
• parameterName
  The name of the parameter to add. For example, SetParameterValue("Contact", "param1", "value1") sets the "param1" parameter on the "Contact" header.
• value
  The value associated with parameterName. If this value contains an empty string (""), the corresponding parameter is deleted.

Return Values

Returns true if the parameter is set successfully; false if it is not (the header does not exist, or a parameter name is not supplied).

Remarks

If the parameter does not exist in the supplied header, the parameter and its associated value are added; if it does exist, the value replaces the existing one. If there is more than one parameter with the same name, this function will replace the first occurrence with the new value. Also, if there are multiple headers with the same name, only the first header is modified.

There is no way to add parameters that are not of the form "param=value".

What did you think of this topic?

© 2008 Microsoft Corporation. All rights reserved.