Direct Access Transport Library Functions      datsrqfree(3DAT)



NAME
     datsrqfree - destroy an instance  of  the  shared  receive
     queue

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

     DATRETURN
         datsrqfree (
         IN      DATSRQHANDLE      srqhandle
         )


PARAMETERS
     srqhandle    A handle for an instance of  SRQ  to  be  des-
                   troyed.


DESCRIPTION
     The datsrqfree() function destroys an instance of the SRQ.
     The SRQ cannot be destroyed if it is in use by an EP.


     It is illegal to use the destroyed handle in any  consequent
     operation.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The srqhandle argument is an  invalid
                           DAT handle.


     DATSRQINUSE        The Shared Receive Queue  can  not  be
                           destroyed because it is in still asso-
                           ciated with an EP instance.


USAGE
     If the Provider detects the use of a deleted object  handle,
     it  should  return  DATINVALIDHANDLE.  The Provider should
     avoid assigning the used handle as long  as  possible.  Once
     reassigned  the  handle is no longer a handle of a destroyed
     object.

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





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datsrqfree(3DAT)



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


SEE ALSO
     datsrqcreate(3DAT),               datsrqpostrecv(3DAT),
     datsrqquery(3DAT),                   datsrqresize(3DAT),
     datsrqsetlw(3DAT), libdat(3LIB), attributes(5)










































SunOS 5.11          Last change: 16 Jul 2004                    2