# dispGetAppCtl

Returns information about default Natural Access usage by the application.

#### Prototype

DWORD dispGetAppCtl (unsigned ctltype, void *buffer, unsigned size)

Argument | Description
clttype | Type of application information desired. Valid value is CTAAPP_CTAFLAGS.
buffer | Pointer to buffer (sized to DWORD) into which to place the application flags.
size | Size of buffer.

#### Return values

Return value | Description
SUCCESS |
CTAERR_BAD_ARGUMENT | buffer is NULL, size is 0, or invalid clttype parameter value.
CTAERR_BAD_SIZE | buffer size is too small.
CTAERR_NOT_INITIALIZED | Natural Access is not initialized.

#### Details

dispGetAppCtl returns information about how the application and the default system settings control the behavior of Natural Access.

The return value the following set of flags:

Flag | Description
--- | ---
CTA_NOTIFY_UPDATE_WAITOBJS | Natural Access sends CTAEVN_UPDATE_WAITOBJS when there is a change to the internal array of Natural Access wait objects.
CTA_MODE_SERVER | The Natural Access Server functionality runs in a Natural Access Server (ctdaemon) that is separate from the application, but on the same host.
CTA_MODE_LIBRARY | The Natural Access Server functionality runs within the process address space.
CTA_COMMS_SERIALIZE | When set, commands from all queues sent to the server are serialized (this is the default). This mode requires fewer system resources, allowing more event queues to be created.
CTA_COMMS_NOTSERIALIZE | When set, commands from all queues sent to the server are not serialized. This mode requires more system resources, limiting the number of event queues that can be created.
CTA_CONTEXTNAME_REQUIRE_UNIQUE | When set, Natural Access cannot modify the context name to ensure uniqueness. If two applications specify the same context name, the second application receives an error.
CTA_CONTEXTNAME_CREATE_UNIQUE | When set, allows the local server to modify context names specified by client applications so that context names are not duplicated (default).

See ctaInitialize in the Natural Access Developer's Reference Manual for more details on these flags.