CCOW ActiveX Context Participant Responsibilities

CCOW ActiveX Context Participant Responsibilities

• Locating the Context Management Registry:

  Register the context manager in the Windows registry. This enables context participant applications to locate and bind to the context manager.

  • ActiveX component registry entries often include implementation-specific information, such as the filename and path to the component's executable code. However, the registry entry for an ActiveX component can use a program identifier (ProgID), which is a symbolic name for the type of component, as a registry key. A registry key is used to locate a registry entry (known as a value).
  • The value associated with a ProgID is the component's class identifier (CLSID), which denotes an implementation of the component. The client uses the ProgID to locate the component's CLSID at run-time.

  To create a context manager reference, call the following:

  Utils.COMCreateObject("CCOW.ContextManager");

• Activating\Creating a Context Session:

  The Leadtools.Ccow.IContextSession interface supports the following operations:

• Activating a Context Session

  .

  Activates a context manager so that it represents the active session for a point-of-use device.

• Creating a Context Session

  Instructs the context manager to create a new context manager.

  Note: A new session deactivates the current session, allowing the users to share the same session.

• Joining a Context Session:

  To join a common context session, create a Context Manager:

  Utils.COMCreateObject("CCOW.ContextManager");

  After a context manager has been created, call the IContextManager.JoinCommonContext method to become a participant.

  Calling the IContextManager.JoinCommonContext method returns a participant coupon (an integer number assigned by the context manager to the application), when it joins a common context session. This coupon is subsequently used by the application to identify itself when it calls a context manager method requiring application identification.

  Note: Setting survey to true when joining the common context means the application will participate in context change surveys. If the parameter is false, the application will only be informed when a context change has been accepted.

• Suspending\Resuming a Context Participant:

  Calling IContextManager.SuspendParticipation enables an application to indicate that it wants to suspend its active participation in a common context session, while remaining registered as a participant.

  To resume a suspended participant in a common context session, call IContextManager.SuspendParticipation

• Getting the Current Context Participant State:

  After the application joins the context session, call the IContextData.GetItemNames and IContextData.GetItemValues methods to get the current context session state.

• Leaving the Context Session:

  To disconnect the application from the context session, call the IContextManager.LeaveCommonContext method.