FWSubmitBmipResponseCallBack(3sadm)

FWSubmitBmipResponseCallBack -- set a callback routine to be called on completion of SCOadmin object requests

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
FWSubmitBmipResponseCallBack(frameWorkCClientData_cl *clientDataPtr,
			     callBackFunction_pt      function,
                             errStatus_cl            *errStatusPtr);

Description

The FWSubmitBmipResponseCallBack() function stores the name of a function that is to be called whenever responses are returned for object requests. This function causes the framework to behave in a modeless fashion.

After calling the function FWSubmitBmipResponseCallBack(), the SCOadmin framework will always return NULL, or an error stack, on subsequent calls to FWBmipSubmitBmipRequest(3sadm). The actual response will be sent, instead, to the function named by the callBackFunction_pt responseFunction parameter. The callBackFunction_pt is described in <scoadmin/callBack.h> as the function:

void
(*callBackFunction_pt)(statusList_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 lists of responses.
errStatusPtr: A pointer to an error stack which can be manipulated with the Error(3sadm) routines.

References

FWInitializeFrameWork(3sadm).