PICL Plug-In Library Functions        ptreepostevent(3PICLTRE)



NAME
     ptreepostevent - post a PICL event

SYNOPSIS
     cc [ flag... ] file... -lpicltree [ library... ]
     #include 

     int ptreepostevent(const char *ename, const void *earg,
          sizet size, void (*completionhandler)(char *ename,
          void *earg, sizet size));


DESCRIPTION
     The ptreepostevent() function posts  the  specified  event
     and  its arguments to the PICL framework. The argument ename
     specifies a pointer to a string containing the name  of  the
     PICL event. The arguments earg and size specify a pointer to
     a buffer containing the event arguments  and  size  of  that
     buffer, respectively. The argument completionhandler speci-
     fies the completion handler to be called after the event has
     been  dispatched to all handlers. A NUL value for a comple-
     tion handler indicates that no handler should be called. The
     PICL  framework  invokes  the completion handler of an event
     with the ename, earg, and size arguments  specified  at  the
     time of the posting of the event.


     PICL events are dispatched in the order in which  they  were
     posted.  They  are  dispatched  by  executing  the  handlers
     registered for that event.  The handlers are invoked in  the
     order in which they were registered.


     New events will  not  begin  execution  until  all  previous
     events  have  finished  execution.  Specifically,  an  event
     posted from an event handler will not begin execution  until
     the current event has finished execution.


     The caller may not reuse or reclaim the resources associated
     with  the  event  name and arguments until the invocation of
     the completion handler.  The completion  handlers  are  nor-
     mally  used to reclaim any resources allocated for the post-
     ing of an event.

RETURN VALUES
     Upon successful completion, 0 is  returned.  On  failure,  a
     non-negative  integer  is returned to indicate an error, the
     event is not posted,  and  the  completion  handler  is  not
     invoked.





SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions        ptreepostevent(3PICLTRE)



ERORS
     PICLINVALIDARG    Invalid argument


     PICLFAILURE       General system failure


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     ptreeregisterhandler(3PICLTRE),
     ptreeunregisterhandler(3PICLTRE), attributes(5)






























SunOS 5.11           Last change: 1 Aug 2000                    2