Share via


GetUriParameter(string,string) function

 
Communications Server 2007 Server SDK Documentation

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.

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