The DllRegisterServer function registers a Cluster Administrator extension DLL with the COM library by adding information to the Microsoft® Windows NT® system registry.
STDAPI DllRegisterServer(void);
Client-side registration must be done on each computer on which Cluster Administrator runs.
When Cluster Administrator calls the OLE function CoCreateInstance, the system registry is examined to find out how to load the extension. Since the Cluster Administrator extension is providing the user interface, the extension must be implemented as an in-process (INPROC) server.
In order for CoCreateInstance to find the correct server, its CLSID must be registered under HKEY_CLASSES_ROOT\CLSID. At the root, an empty-named value must contain the name of the Cluster Administrator extension. Three subkeys are situated below the root:
An empty-named value must be defined at the InProcServer32 key to contain the path to the extension DLL. An empty-named value must be defined at the ProgID and VersionIndependentProgID keys to contain the short name of the extension.
To complete the registration, create a key at "HKEY_CLASSES_ROOT\CLUADMEX.<short name of extension>". An empty-named value must be defined there with the name of the extension. Below that, a CLSID key must be defined, with an empty-named value containing the extension CLSID.
Here is an example of the registry entries for a Cluster Administrator extension named FileSmpEx with a CLSID of {00000000-0000-0000-0000-000000000000}:
HKEY_CLASSES_ROOT
CLSID {00000000-0000-0000-0000-000000000000} =
Cluster Administrator File Share Sample Extension (FileSmpEx) 1.0
InprocServer32 = filesmpex.dll
ProgID = CLUADMEX.FileSmpEx
VersionIndependentProgID = CLUADMEX.FileSmpEx
CLUADMEX.FileSmpEx = Cluster Administrator File Share Sample Extension(FileSmpEx) 1.0
CLSID = {00000000-0000-0000-0000-000000000000}
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in cluadmex.h.