GetUserAtHost(uri) function

Microsoft Office Live Communications Server 2005 with SP1


The GetUserAtHost function takes a Uniform Resource Indicator (URI) string and extracts the user@hostname, if present. If a user@hostname value is not present, the function returns null.



  • uri
    A A SIP URI whose hostname 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, GetUserAtHost("") returns the string "".

Return Values

Returns a string in the form user@hostname. 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 Live Communications Server 2005 with SP1.

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