ARDBCRollbackTransaction

Description

This function rolls back the changes of one or more AR System Database Connectivity (ARDBC) calls to the external data source. The plug-in server calls this function when one or more actions that read or modified the external data source failed or resulted in an error. After the plug-in server issues this function, the AR System server begins the next transaction.

Important

If you do not define this function and the plug-in server receives a roll back transaction request, the AR System server does not process the request and does not return an error.

Synopsis

#include "ardbc.h"

int ARDBCRollbackTransaction(
  void *object,
  ARInternalId transId,
  ARStatusList *status)

Input arguments

object

Pointer to the plug-in instance that the call to ARPluginCreateInstance returned.

transId

Transaction identification number (transaction ID) that the plug-in server designates for each transaction.

The transaction ID is unique to the thread that the AR System server uses to access the ARDBC plug-in. There is only one open transaction per server thread.

Return values

status

List of zero or more notes, warnings, or errors generated from a call made to this function.

For a description of all possible values, see Error-checking.