IN_UnregisterQuery

All Editions image\bltlrgsq_shg.gif Related Functions  image\bltlrgsq_shg.gif Example

The IN_UnregisterQuery function unregisters a query advise. Imagenation sends a query when specific action occurs through the user interface. An advise request is similar to a DDE advise, but the C API advise can be placed on specific objects. When the requested event occurs, the related callback function is called. Then, Imagenation must wait until the client returns a response to the query to know what action to take. Generally, advises are registered at the beginning of a session, and unregistered when the session ends.

Syntax

int IN_UnregisterQuery( queryID, objectID, callback )

Parameters

Values

Meaning

SHORT queryID

IN_QRY_*

the query advise to unregister

IN_OBJECT objectID

IN_SYSTEM_OBJECT system (global to Imagenation)

objectID identifier of object for which to unregister the query advise

ULONG callback

Callback functions

the function called when the query is sent

Release information

Added to Imagenation for Windows in Release 4.20.

As of Release 5.1, also available in Imagenation for UNIX.

Also supported in Imagenation 3.3 for UNIX.

See also

Controlling notifications and queries