This documentation supports the 18.05 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.



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.


Retrieves a list of all available external data source tables (schema candidates). Users select fields from these candidates to populate the vendor form.


The system returns information based on the access privileges of the user that you specify for the control parameter. All lists, therefore, are limited to forms the user can access.


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

int ARGetListExtSchemaCandidates(
   ARControlStruct *control,
   unsigned int schemaType,
   ARCompoundSchemaList *schemaList,
   ARStatusList *status)

Input arguments


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.


A value that indicates the form types to retrieve.

Bit 7:

Retrieve all view schemas (AR_SCHEMA_VIEW).

Bit 8:

Retrieve all vendor schemas (AR_SCHEMA_VENDOR).


To retrieve both visible and hidden forms, add 1024 (AR_HIDDEN_INCREMENT) to the form type. For example, specify AR_SCHEMA_VENDOR | AR_HIDDEN_INCREMENT for this parameter.

Return values


A list of zero or more (accessible) forms that match the criteria in the schemaType parameter. Specify NULL for this parameter if you do not want to retrieve the list.


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.

See also

ARGetMultipleExtFieldCandidates. See FreeAR for: FreeARCompuondSchemaList, AFreeARStatusList.

Was this page helpful? Yes No Submitting... Thank you