ARDBCRollbackTransaction

Description

This function rolls back the changes of one or more previous ARDBC calls to the external data source. The plug-in server calls this function when one or more actions that read or modify the external data source result in a failed operation or 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 to this function. For a description of all possible values, see Error-checking.