1dat_provider_init(3DDAiTr)ect Access Transport Library Functdiaotn_sprovider_init(3DAT)
2
3
4

NAME

6       dat_provider_init - locate the Provider in the Static Registry
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       void
13           dat_provider_init (
14           IN    const DAT_PROVIDER_INFO    *provider_info,
15           IN    const char *               instance_data
16           )
17
18

PARAMETERS

20       provider_info    The  information  that was provided by the Consumer to
21                        locate the Provider in the Static Registry.
22
23
24       instance_data    The instance data string obtained from the entry found
25                        in the Static Registry for the Provider.
26
27

DESCRIPTION

29       A constructor the Registry calls on a Provider before the first call to
30       dat_ia_open(3DAT) for a given IA name when the Provider is auto-loaded.
31       An  application  that explicitly loads a Provider on its own can choose
32       to use dat_provider_init() just as the Registry would have done for  an
33       auto-loaded Provider.
34
35
36       The  Provider's  implementation  of  this  method  must  call  dat_reg‐
37       istry_add_provider(3DAT),    using    the    IA     name     in     the
38       provider_info.ia_name  field,  to register itself with the Dynamic Reg‐
39       istry. The implementation must not register  other  IA  names  at  this
40       time.  Otherwise, the Provider is free to perform any initialization it
41       finds useful within this method.
42
43
44       This method is called before the first  call  to  dat_ia_open()  for  a
45       given IA name after one of the following has occurred:
46
47           o      The Provider library was loaded into memory.
48
49           o      The  Registry  called  dat_provider_fini(3DAT)  for  that IA
50                  name.
51
52           o      The Provider called  dat_registry_remove_provider(3DAT)  for
53                  that  IA name (but it is still the Provider indicated in the
54                  Static Registry).
55
56
57       If this method fails, it should ensure that it does not leave its entry
58       in the Dynamic Registry.
59

RETURN VALUES

61       No values are returned.
62

ATTRIBUTES

64       See attributes(5) for descriptions of the following attributes:
65
66
67
68
69       ┌─────────────────────────────┬─────────────────────────────┐
70       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
71       ├─────────────────────────────┼─────────────────────────────┤
72       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
73       ├─────────────────────────────┼─────────────────────────────┤
74       │MT-Level                     │                             │
75       └─────────────────────────────┴─────────────────────────────┘
76

SEE ALSO

78       dat_ia_open(3DAT),           dat_provider_fini(3DAT),          dat_reg‐
79       istry_add_provider(3DAT),   dat_registry_remove_provider(3DAT),    lib‐
80       dat(3LIB), attributes(5)
81
82
83
84SunOS 5.11                        16 Jul 2004          dat_provider_init(3DAT)
Impressum