ARDeleteEntry

Note

You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.

Description

Deletes the form entry with the indicated ID from the specified server. You can delete entries only from base forms. To remove entries from join forms, delete them from the underlying base forms.

Privileges

BMC Remedy AR System administrator.

Synopsis

#include "ar.h"
#include "arerrno.h"
#include "arextern.h"
#include "arstruct.h"

int ARDeleteEntry(
  ARControlStruct *control,
  ARNameType schema,
  AREntryIdList *entryId,
  unsigned int option,
  ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.

schema

The name of the base form containing the entry to delete.

entryId

A list of values of type AREntryIdType that identify the entries. For entries of join schemas, the list contains the entry IDs for all the member forms. For other schemas, the list contains one entry ID.

option

The policy that controls the deletion of entries for join schemas.The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

Return values

status

A 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.