1 mike  1.1.2.1                         Static Provider Registration
 2                                       ============================
 3               
 4               
 5               SYNOPSIS:
 6               =========
 7               
 8               This document explains how to register static providers using the
 9               EmbeddedServer class. An example of this is included under:
10               
11                   pegasus/vxworks/cimserver/MyEmbeddedServer.cpp
12               
13               PREPARING THE STATIC PROVIDER MODULE
14               ====================================
15               
16               The only requirement of the provider is that it include the 
17               "PegasusCreateProvider" entry point. This is standard for Pegasus C++
18               providers and CIMPLE providers include this entry point when module.cpp
19               is compiled with the following option:
20               
21                   -DCIMPLE_PEGASUS_MODULE
22 mike  1.1.2.1 
23               Caution: Do not rename this entry point as was required in a previous version
24               of the static provider mechanism.
25               
26               There may be at most one PegasusCreateProvider entry point in the entire
27               server.
28               
29               STATICALLY REGISTERING THE PROVIDER
30               ===================================
31               
32               To statically register the provider, first register the PegasusCreateProvider
33               entry point by overriding EmbeddedServer::initialize() and adding the following
34               code fragment (see pegasus/vxworks/cimserver/MyEmbeddedServer.cpp for an
35               example).
36               
37                   if (!registerPegasusCreateProviderEntryPoint(PegasusCreateProvider))
38                   {
39                       /* Error */
40                   }
41               
42               Next, register each provider with the following fragment (replacing CLASSNAME
43 mike  1.1.2.1 with the name of that provider's class).
44               
45                   if (!registerProvider(
46                       nameSpaces,
47                       CLASSNAME,
48                       MyEmbeddedServer::PEGASUS_PROVIDER_INTERFACE,
49                       MyEmbeddedServer::INSTANCE_PROVIDER_TYPE))
50                   {
51                       /* Error */
52                   }
53