PITrail Event
This event is fired for all protocol messages.
Syntax
ANSI (Cross Platform) virtual int FirePITrail(XMPPPITrailEventParams *e);
typedef struct {
int Direction;
const char *Pi; int reserved; } XMPPPITrailEventParams; Unicode (Windows) virtual INT FirePITrail(XMPPPITrailEventParams *e);
typedef struct {
INT Direction;
LPCWSTR Pi; INT reserved; } XMPPPITrailEventParams;
- (void)onPITrail:(int)direction :(NSString*)pi;
#define EID_XMPP_PITRAIL 9 virtual INT IPWORKS_CALL FirePITrail(INT &iDirection, LPSTR &lpszPi);
Remarks
The PITrail event is useful for debugging purposes. It shows all the interaction between the client and the server, line by line.
SessionId will hold the session number that originated the PI. A value of 0 is reserved for all PI dealing with the IMServer.
The direction parameter shows the originator of the message:
| 0 (Client) | Pi originates from the client. |
| 1 (Server) | Pi originates from the server. |
| 2 (Info) | Pi is an informative message originating from within the class. |
The Pi parameter contains the PI message.