IUccContainer Interface

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.

Encapsulates a container of category instance and member scope.

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

Syntax

'Declaration
Public Interface IUccContainer
    Inherits IUnknown

public interface IUccContainer : IUnknown

public interface class IUccContainer : IUnknown

public interface IUccContainer extends IUnknown

public interface IUccContainer extends IUnknown

Remarks

An IUccCategoryInstance object whose context is "containers" is created by the server when it is specified but does not already exist. An instance of this interface can be queried to obtain an instance of IUccContainer. This interface is used to provide access control of the contained category instances. A container holds a set of category instances and a list of container members. A category instance is added to the container when the category instance is published. A container member identifies a specific user or a group of users belonging to a specific network domain or a set of trusted domains. Each member is represented by an IUccContainerMember instance.

Containers are provisioned on a local client using the OnCategoryInstanceAdded event. A client receives multiple container instances. It is a good idea to maintain a collection of received containers in a client cache.

Win32 COM/C++ Syntax

interface IUccContainer : IUnknown

Example

The following example handles the OnCategoryInstanceAdded event and casts the received category instance to the IUccContainer interface. This obtained interface is wrapped by the client into the Container class and added to a collection of Container class instances. Finally, the client advises the received category instance of the event source for events raised by the category instance.

void _IUccCategoryContextEvents.OnCategoryInstanceAdded(
   IUccCategoryContext pCategoryCtx, 
   UccCategoryInstanceEvent pCategory)
{
   IUccCategoryContext catContext = pCategory.CategoryInstance.CategoryContext;
   switch (catContext.Name.ToLower())
   {
      case "contacts":
         break;
      case "groups":
         break;
      case "subscribers":
         break;
      case "categories":
         break;
      case "containers":
         Container _containerClass = new Container(pCategory.CategoryInstance as IUccContainer);
         containers.Add(
            pCategory.CategoryInstance.InstanceId, 
            _containerClass);
         UCC_Advise<_IUccCategoryInstanceEvents>(
            pCategory.CategoryInstance,
            this);
         break;
      default:
         break;
   }
}

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

IUccContainer Members
Microsoft.Office.Interop.UccApi Namespace