ConnectionError Event

Fires when QuickBooks Web Connector is unable to connect to QuickBooks.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FireConnectionError(QBWCServerConnectionErrorEventParams *e);

typedef struct {
  const char *SessionTicket;
  const char *ErrorCode;
  const char *ErrorMessage;
  char *CompanyFile;
  int reserved;
} QBWCServerConnectionErrorEventParams;

Unicode (Windows)
virtual INT FireConnectionError(QBWCServerConnectionErrorEventParams *e);

typedef struct {
  LPCWSTR SessionTicket;
  LPCWSTR ErrorCode;
  LPCWSTR ErrorMessage;
  LPWSTR CompanyFile;
  INT reserved;
} QBWCServerConnectionErrorEventParams;

- (void)onConnectionError:(NSString*)sessionTicket :(NSString*)errorCode :(NSString*)errorMessage :(NSString**)companyFile;

#define EID_QBWCSERVER_CONNECTIONERROR 4

virtual INT INQB_CALL FireConnectionError(LPSTR &lpszSessionTicket, LPSTR &lpszErrorCode, LPSTR &lpszErrorMessage, LPSTR &lpszCompanyFile);

Remarks

This event fires when QuickBooks Web Connector is unable to connect to QuickBooks. The event parameters provide the error details, and also allow you to specify an alternate company file to retry the connection with. If an alternate company file is not specified the session is ended. The parameters are as follows:

ErrorCode is the error code (HResult) returned by QuickBooks. This value is read-only.

ErrorMessage is the error message returned by QuickBooks. This value is read-only.

CompanyFile may be set to the full path of an alternate company file. If specified, the QuickBooks Web Connector will retry the connection to QuickBooks using this company file. Leave this parameter empty to end the session.