SubscriptionRequest Event

This event fires when a subscription request is received.

Syntax

class XMPPSubscriptionRequestEventParams {
public:
  const QString &From();
  const QString &Domain();
  bool Accept();
  void SetAccept(bool bAccept);
  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SubscriptionRequest(XMPPSubscriptionRequestEventParams *e);

// Or, subclass XMPP and override this emitter function.
virtual int FireSubscriptionRequest(XMPPSubscriptionRequestEventParams *e) {...}

Remarks

This event fires whenever another XMPP entity requests a subscription to this entity's presence. The XMPP class will parse the requesting entity's Jabber ID into the From and Domain parameters. There is no need to know which resource sent the request, since all instances of the requesting entity's account have access to the same roster.

Accept will initially be false, but setting it to true will cause the XMPP class to allow the remote subscription. Otherwise, the XMPP class will actively deny the subscription request.