Open Client Client-Library/C Reference Manual

ct_callback

Parameters

context

A pointer to a CS_CONTEXT structure. A CS_CONTEXT structure defines a Client-Library application context.

Either context or connection must be NULL:

If context is supplied, the callback is installed as a "default" callback for the specified context. Once installed, a default callback is inherited by all connections subsequently allocated within the context.
If context is NULL, the callback is installed for the individual connection specified by connection.

connection

A pointer to a CS_CONNECTION structure. A CS_CONNECTION structure contains information about a particular client/server connection.

Either context or connection must be NULL:

If connection is supplied, the callback is installed for the specified connection.
If connection is NULL, the callback is installed for the application context specified by context.

action

One of the following symbolic values:

Value of action	Meaning
CS_SET	Installs a callback
CS_GET	Retrieves the currently installed callback of this type

type

The type of callback routine of interest. The following table lists the symbolic values for type:

Values for ct_callback type parameter
Value of type	Meaning
CS_CLIENTMSG_CB	A client message callback, as described in "Client message callbacks".
CS_COMPLETION_CB	A completion callback, as described in "Completion callbacks".
CS_DS_LOOKUP_CB	A directory callback, as described in "Directory callbacks".
CS_ENCRYPT_CB	An encryption callback, as described in "Encryption callbacks".
CS_CHALLENGE_CB	A negotiation callback, as described in "Negotiation callbacks".
CS_NOTIF_CB	A registered procedure notification callback, as described in "Notification callbacks".
CS_SECSESSION_CB	A security session callback, as described in "Security session callbacks".
CS_SERVERMSG_CB	A server message callback, as described in "Server message callbacks".
CS_SIGNAL_CB + signal_number	A signal callback, as described in "Signal callbacks". Signal callbacks are identified by adding the signal number of interest to the manifest constant CS_SIGNAL_CB. For example, to install a signal callback for a SIGALRM signal, pass type as CS_SIGNAL_CB + SIGALRM.

func

A pointer variable.

If a callback routine is being installed, func is the address of the callback routine to install.

If a callback routine is being retrieved, ct_callback sets *func to the address of the currently installed callback routine.


	Expand Search