GetUserName(string) function

GetUserName

The GetUserName function returns the user name portion of a SIP URI.

stringGetUserName(stringuri);

Parameters

• uri
  A SIP URI whose hostname portion is returned. The function accepts only a valid SIP URI string in the following form: where "Display Name" <sip:user@host:port;param=value> For example, GetUserName("sip:someone@example.com") returns "someone".

Return Values

Returns the user name as a string. Returns null if 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 Live Communications Server 2005 with SP1.

Remarks

The user name occurs in a SIP URI before the host name, separated by an "@" (at) symbol. For example, a URI specified as "sip:someone@example.com" would have a user name of "someone".