FWSubmitBmipEventCallBack(3sadm)

FWSubmitBmipEventCallBack -- set a callback routine to be called on generation of SCOadmin object events

Synopsis

CC ... -lsysadm -lvtcl -ltclx -ltcl -lsocket -lgen -lm

#include <scoadmin/basicIncl.h>
#include <scoadmin/callBack.h>
#include <scoadmin/statusLst.h>
#include <scoadmin/CAPI.h>

void
FWSubmitBmipEventCallBack(frameWorkCClientData_cl *clientDataPtr,
			     eventFunction_pt      function,
                             errStatus_cl         *errStatusPtr);

Description

The FWSubmitBMIPEventCallBack() function stores the name of a function that is to be called upon the generation of events by a SCOadmin object class. This function allows the caller to have the SCOadmin framework behave in a modeless manner.

The eventFunction_pt is described in <scoadmin/callBack.h> as the function:

void
(*eventFunction_pt)(bmipResponse_pt, errStatus_cl *)

Arguments

clientDataPtr: A pointer to the framework internal C/C++ client data as provided by FWInitializeFrameWork(3sadm).
function: A pointer to the client function that will handle returned events.
errStatusPtr: A pointer to an error stack which can be manipulated with the Error(3sadm) routines.

References

FWInitializeFrameWork(3sadm).