Direct Access Transport Library Functions      datepquery(3DAT)



NAME
     datepquery - provide parameters of the Endpoint

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

     DATRETURN
         datepquery (
         IN    DATEPHANDLE        ephandle,
         IN    DATEPARAMASK    epparammask,
         OUT   DATEPARAM         *epparam
         )


PARAMETERS
     ephandle        Handle for an instance of the Endpoint.


     epparammask    Mask for Endpoint parameters.


     epparam         Pointer to a  Consumer-allocated  structure
                      that   the  Provider  fills  with  Endpoint
                      parameters.


DESCRIPTION
     The datepquery() function provides  the  Consumer  parame-
     ters, including attributes and status, of the Endpoint. Con-
     sumers pass in a pointer  to  Consumer-allocated  structures
     for Endpoint parameters that the Provider fills.


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


     Some of the parameters only have values for certain Endpoint
     states.  Specifically,  the values for remoteiaaddress and
     remoteportqual  are  valid  only  for  Endpoints  in   the
     DATEPSTATEPASIVECONECTIONPENDING,
     DATEPSTATEACTIVECONECTIONPENDING,
     DATEPSTATETENTATIVECONECTIONPENDING,
     DATEPSTATEDISCONECTPENDING,
     DATEPSTATECOMPLETIONPENDING,  or  DATEPSTATECONECTED
     states. The values of localportqual is valid only for End-
     points   in   the   DATEPSTATEPASIVECONECTIONPENDING,
     DATEPSTATEACTIVECONECTIONPENDING,
     DATEPSTATEDISCONECTPENDING,



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datepquery(3DAT)



     DATEPSTATECOMPLETIONPENDING,  or  DATEPSTATECONECTED
     states,  and  might  be  valid for DATEPSTATEUNCONECTED,
     DATEPSTATERESERVED,
     DATEPSTATETENTATIVECONECTIONPENDING,
     DATEPSTATEPASIVECONECTIONPENDING,                 and
     DATEPSTATEUNCONECTED states.

RETURN VALUES
     DATSUCES              The operation was successful.


     DATINVALIDHANDLE       The ephandle parameter is invalid.


     DATINVALIDPARAMETER    The  epparammask   parameter   is
                              invalid.


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