Returns information about default Natural Access usage by the application.
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 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. |
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.