User Guide

1038 Chapter 6: ColdFusion MX Event Gateway Reference
removePermit
Description
Removes an ID from a group in the permit list for the gateway. If the gateway’s permit mode is
PERMIT_SOME, the specified user cannot receive messages on the gateway's presence state.
Syntax
Boolean = removePermit(name, group)
See also
addDeny
, addPermit, getDenyList, getPermitList, getPermitMode, removeBuddy,
removeDeny, setPermitMode, “Using the GatewayHelper object” in Chapter 43, “Using the
Instant Messaging Event Gateways” in ColdFusion MX Developer’s Guide
Parameters
Returns
True if the ID was removed from the group; 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
always returns False.
Usage
If the user is in multiple groups in your permit list, you remove the user separately from each
group. However, the IM server stops sending status updates when you remove the user from the
first group.
Example
See “GatewayHelper example”, in Chapter 43, “Using the Instant Messaging Event Gateways” in
ColdFusion MX Developer’s Guide, which uses all GatewayHelper class methods.
Parameter Description
name The unique instant messaging user name for the person to remove from the permit
list.
group The name of the group from which you want to remove the user. If the parameter is
the empty string, the gateway uses the General group.