UccUriManager Class

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Represents a co-creatable class for constructing a URI supported by the Unified Communications Client API. The class can be co-created.

Namespace: Microsoft.Office.Interop.UccApi
Assembly: Microsoft.Office.Interop.UccApi (in microsoft.office.interop.uccapi.dll)

Syntax

'Declaration
Public Class UccUriManager

public class UccUriManager

public ref class UccUriManager

public class UccUriManager

public class UccUriManager

Remarks

This class implements the IUccUriManager interface. The default interface is IUccUriManager. An application obtains the default interface on the class instance directly. Non-default interfaces, if any, can be obtained by calling QueryInterface on the default interface. This class can be co-created.

A Uri Manager is the factory object for the IUccUri interface. IUccUri encapsulates a Uniform Resource Identifier (URI). A network resource is an endpoint representing a user, a user's proxy endpoint phone, or a remote server. The Unified Communications API set includes many classes related to interaction with remote endpoints. To identify a specific endpoint an instance of one of these classes will represent, the client must provide a class with an instance of IUccUri. The IUccUri interface exposes methods and properties allowing the client to build a properly formatted Uri address.

Win32 COM/C++ Syntax

coclass UccUriManager
{
   [default] interface IUccUriManager;
};

Inheritance Hierarchy

System.Object
  Microsoft.Office.Interop.UccApi.UccUriManager

Example

A client application requires only one instance of the Uri Manager. It is used frequently to create instances of IUccUri. For this reason, a client should create one global instance of the Uri Manager and make it available for any class in the client application to use. The following example instantiates a Uri Manager and sets the sope of the object to allow all classes within the assembly to reference it.

internal static IUccUriManager _UriManager = new UccUriManagerClass();

With an instantiated Uri Manager, a client can create a UccUri class instance at any time where a UccUri is necessary. In the following example, a client must have an instance of IUccConferenceManager to create a conference manager session (IUccConferenceManagerSession). The code example is taken from a class that has instantiated an IUccEndpoint interface as endpoint.

_confManager = endpoint as IUccConferenceManager;
UccUri u = _UriManager.ParseUri("sip:jaya@contoso.com;gruu;opaque=app:conf:focusfactory");
_confManagerSession = _confManager.CreateConferenceManagerSession(u);

Thread Safety

All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2000 with Service Pack 4, Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

See Also

Reference

UccUriManager Members
Microsoft.Office.Interop.UccApi Namespace