Direct Access Transport Library Functions      datevdfree(3DAT)



NAME
     datevdfree - destroy an instance of the Event Dispatcher

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

     DATRETURN
         datevdfree (
         IN    DATEVDHANDLE    evdhandle
         )


PARAMETERS
     evdhandle    Handle  for   an   instance   of   the   Event
                   Dispatcher.


DESCRIPTION
     The datevdfree() function destroys a specified instance of
     the Event Dispatcher.


     All events on the queue of the  specified  Event  Dispatcher
     are  lost.  The destruction of the Event Dispatcher instance
     does not have any effect on any DAT Objects that  originated
     an  Event Stream that had fed events to the Event Dispatcher
     instance. There should be no event streams feeding the Event
     Dispatcher  and  no  threads blocked on the Event Dispatcher
     when the EVD is being closed as at  the  time  when  it  was
     created.


     Use of the handle of the destroyed Event Dispatcher  in  any
     consequent operation fails.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The evdhandle parameter is invalid


     DATINVALIDSTATE     Invalid  parameter.  There  are  Event
                           Streams   associated  with  the  Event
                           Dispatcher feeding it.


USAGE
     Consumers are advised to destroy all Objects that  originate
     Event  Streams that feed an instance of the Event Dispatcher
     before destroying it. An exception to  this  rule  is  Event



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datevdfree(3DAT)



     Dispatchers of an IA.


     Freeing an IA automatically destroys all Objects  associated
     with  it  directly and indirectly, including Event Dispatch-
     ers.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard: uDAPL, 1.1, 1.2   
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     libdat(3LIB), attributes(5)































SunOS 5.11          Last change: 16 Jul 2004                    2