Direct Access Transport Library Functions      datcrquery(3DAT)



NAME
     datcrquery - provide parameters of the Connection Request

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

     DATRETURN
         datcrquery (
         IN    DATCRHANDLE        crhandle,
         IN    DATCRPARAMASK    crparammask,
         OUT   DATCRPARAM         *crparam
         )


PARAMETERS
     crhandle        Handle for  an  instance  of  a  Connection
                      Request.


     crparammask    Mask for Connection Request parameters.


     crparam         Pointer to a  Consumer-allocated  structure
                      that   the  Provider  fills  for  Consumer-
                      requested parameters.


DESCRIPTION
     The datcrquery() function provides to the Consumer parame-
     ters  of  the  Connection  Request. The Consumer passes in a
     pointer to the Consumer-allocated structures for  Connection
     Request parameters that the Provider fills.


     The crparammask  parameter  allows  Consumers  to  specify
     which  parameters  to query. The Provider returns values for
     crparammask requested parameters. The Provider can  return
     values for any other parameters.

RETURN VALUES
     DATSUCES              The operation was successful


     DATINVALIDHANDLE       The crhandle handle is invalid.


     DATINVALIDPARAMETER    The  crparammask   parameter   is
                              invalid.






SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datcrquery(3DAT)



USAGE
     The Consumer uses datcrquery() to  get  information  about
     requesting  a remote Endpoint as well as a local Endpoint if
     it was allocated by the Provider for the arrived  Connection
     Request.  The local Endpoint is created if the Consumer used
     PSP with DATPSPROVIDER as the value  for  pspflags.  For
     the     remote     Endpoint,     datcrquery()     provides
     remoteiaaddress and  remoteportqual.  It  also  provides
     remote peer privatedata and its size.

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                     Safe                        
    


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




























SunOS 5.11          Last change: 16 Jul 2004                    2