GetUriParameter(string,string) function

GetUriParameter

The GetUriParameter function returns the named parameter value found in a supplied SIP URI.

string GetUriParameter(
  string uri,
  string parameterName
);

Parameters

• uri
  A SIP URI whose parameterName portion is returned. The function accepts only a valid SIP URI string in the following form:

  "Display Name" <sip:user@host:port;param=value>

  where "Display Name", :port and ;param=value are optional.

  For example, GetUriParameter("sip:someone@example.com:6767;uriparam1=value1", "uriparam1") returns "value1".

• parameterName
  The parameter name for which the associated value will be returned. In the above example, the parameter name is the string "uriparam1".

Return Values

Returns the value of the parameter specified by parameterName within the supplied URI. Returns null if the requested data is not found or if the URI passed in is not a valid SIP URI in the form specified above. Live Communications Server 2003 applications that pass non-SIP URI strings to this function need to be modified to work properly with Office Communications Server 2007.

Remarks

If the parameter is valueless (it is not of the form "name=value"), this function returns null.