GetUserAtHost(uri) function

Microsoft Office Live Communications Server 2005 with SP1

GetUserAtHost

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.

stringGetUserAtHost(uriuri);

Parameters

  • 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("sip:someone@example.com") returns the string "someone@example.com".

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.