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)

Parameters

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.

Returns

True if the ID was removed from the group; False, otherwise.

Note: If the XMPP 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 the Developing ColdFusion Applications, which uses all GatewayHelper class methods.