Direct Access Transport Library Functions    datcrhandoff(3DAT)



NAME
     datcrhandoff - hand off the Connection Request to  another
     Service Point

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

     DATRETURN
         datcrhandoff (
         IN    DATCRHANDLE    crhandle,
         IN    DATCONQUAL    handoff
         )


PARAMETERS
     crhandle    Handle to an instance of a  Connection  Request
                  that the Consumer is handing off.


     handoff      Indicator of another  Connection  Qualifier  on
                  the  same  IA  to which this Connection Request
                  should be handed off.


DESCRIPTION
     The  datcrhandoff()  function  hands  off  the  Connection
     Request to another Service Point specified by the Connection
     Qualifier handoff.


     The operation is synchronous. This operation  also  destroys
     the  Connection  Request  instance. Use of the handle of the
     destroyed Connection Request  in  any  consequent  operation
     fails.

RETURN VALUES
     DATSUCES              The operation was successful.


     DATINVALIDHANDLE       The crhandle parameter is invalid.


     DATINVALIDPARAMETER    The handoff parameter is invalid.


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    datcrhandoff(3DAT)



     
           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