setPermitMode

Description

Sets the gateway’s permit mode on the IM server. The permit mode determines whether all users can get the gateway's online state information, or whether the server uses a permit list or a deny list to control which users get state information.

Syntax

Boolean = setPermitMode(permitMode)

See also

addDeny, addPermit, getDenyList, getPermitList, getPermitMode, removeDeny, removePermit, Using the GatewayHelper object in Using the Instant Messaging Event Gateways in ColdFusion MX Developer’s Guide

Parameters

Parameter

Description

permitMode

The permission mode, one of the following:

  • PERMIT_ALL Permits all users to be aware of the gateway’s online presence and state. This is the default mode if you do not call this function.
  • PERMIT_SOME Permits only users in the permit list to be aware of the gateway’s online presence and state.
  • DENY_SOME Prevents all users in the deny list from being aware of the gateway’s online presence and state.

Returns

True if the permit mode was set; False otherwise.

Note: XMPP permission management is included in the XMPP 1.0 draft specification, but several XMPP servers that were available at the time of the ColdFusion MX 7 release do not support permission management. If the server does not support permission management, this function returns False to all values except PERMIT_ALL.

Example

See GatewayHelper example, in Using the Instant Messaging Event Gateways in ColdFusion MX Developer’s Guide, which uses all GatewayHelper class methods.