IAppletSession

The IAppletSession interface represents a NetMeeting 3 client application connecting to a specified conference through low-level T.124 Generic Conference Control (GCC) applet Service Access Point (SAP) and T.122/T.125 Multipoint Communication Service (MCS) Applet SAPs from the T.120 standard. IAppletSession supports the following features.

  • Allowing an applet to join and leave a conference at will.
  • Allowing an applet access to resources at the conference level, such as the GCC registry, MCS channels, and MCS tokens after joining a conference.
  • Allowing an applet to query applet roster lists.
  • Launching applets remotely.
  • Registering an IAppletSessionNotify event sink to receive notifications for events triggered by IAppletSession methods.

All transport layer information and parameters for data communication are specified through the IPluggableTransport methods independently of IAppletSession and IApplet methods.

When to Implement

NetMeeting provides a system implementation for IAppletSession. You must implement the notification sink IAppletSessionNotify methods that correspond to events generated by IAppletSession methods.

When to Use

Use the IAppletSession interface methods to manage the communication between an applet and a single NetMeeting conference. Create a Session object indirectly through IAppletNotify::AutoJoinSessionIndication or directly through IApplet::CreateSession after you receive the notification IAppletNotify::PermitToJoinSessionIndication with permission to join granted. Register to receive notifications for the Applet Session object through IAppletSession::Advise.

Methods in Vtable Order

IUnknown MethodsDescription
QueryInterfaceReturns pointers to supported interfaces.
AddRefIncrements reference count.
ReleaseDecrements reference count.

IAppletSession MethodsDescription
GetConfIDRetrieves the conference identifier.
IsThisNodeTopProviderRetrieves whether this node is the conference manager.
JoinEnables an applet to join a conference.
LeaveEnables an applet to leave a conference.
SendDataHandles both uniform and nonuniform send operations to one or more conference members.
InvokeAppletInvokes an applet remotely.
InquireRosterRetrieves information about an applet's roster.
RegistryRequestManipulates the registry in this conference.
ChannelRequestManipulates the channels in this conference.
TokenRequestManipulates the tokens in this conference.
AdviseRegisters sink for IAppletSessionNotify notifications.
UnAdviseUnregisters sink for IAppletSessionNotify notifications.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires NetMeeting 3.0 or later.
  Header: Iapplet.idl.

See Also

IAppletSessionNotify, IApplet, IAppletNotify, Standards and Interoperability, Further Reading

 

Show: