In This Topic ▼

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<IContextManager>("CCOW.ContextManager");
```

Activating\Creating a Context Session:

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

1. #### Activating a Context Session . Activates a context manager so that it represents the active session for a point-of-use device.

2. #### 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<IContextManager>("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.