Direct Access Transport Library Functions
                                          datproviderinit(3DAT)



NAME
     datproviderinit - locate the Provider in the Static Regis-
     try

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

     void
         datproviderinit (
         IN    const DATPROVIDERINFO    *providerinfo,
         IN    const char *               instancedata
         )


PARAMETERS
     providerinfo    The information that was  provided  by  the
                      Consumer  to  locate  the  Provider  in the
                      Static Registry.


     instancedata    The instance data string obtained from  the
                      entry  found in the Static Registry for the
                      Provider.


DESCRIPTION
     A constructor the Registry calls on a  Provider  before  the
     first call to datiaopen(3DAT) for a given IA name when the
     Provider is  auto-loaded.  An  application  that  explicitly
     loads   a   Provider   on   its   own   can  choose  to  use
     datproviderinit() just as the Registry would have done for
     an auto-loaded Provider.


     The Provider's  implementation  of  this  method  must  call
     datregistryaddprovider(3DAT),  using  the  IA name in the
     providerinfo.ianame field, to  register  itself  with  the
     Dynamic Registry. The implementation must not register other
     IA names at this time. Otherwise, the Provider  is  free  to
     perform  any  initialization  it  finds  useful  within this
     method.


     This method is called before the first call to datiaopen()
     for a given IA name after one of the following has occurred:

         o    The Provider library was loaded into memory.

         o    The  Registry  called  datproviderfini(3DAT)  for
              that IA name.



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions
                                          datproviderinit(3DAT)



         o    The                 Provider                 called
              datregistryremoveprovider(3DAT) for that IA name
              (but it is still  the  Provider  indicated  in  the
              Static Registry).


     If this method fails, it should  ensure  that  it  does  not
     leave its entry in the Dynamic Registry.

RETURN VALUES
     No values are returned.

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                                                 
    


SEE ALSO
     datiaopen(3DAT),                  datproviderfini(3DAT),
     datregistryaddprovider(3DAT),
     datregistryremoveprovider(3DAT),   libdat(3LIB),   attri-
     butes(5)






















SunOS 5.11          Last change: 16 Jul 2004                    2






Direct Access Transport Library Functions
                                          datproviderinit(3DAT)






















































SunOS 5.11          Last change: 16 Jul 2004                    3