GetUriParameter

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

Syntax

  Copy imageCopy Code
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 R2.

Remarks

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