Installing Administrator Extension

An administrator extension must be properly installed in order to work. In general, the following needs to be done:

Create an Admin-Extension object in MS Exchange directory.
Build an extension DLL and put it in \\SERVER\Add-Ins\<extension-name>\<hardware-platform> directory.
Associate a designated directory object with your extension by introducing (or modifying) its Extension-Name attribute.

This is explained in more detail below.

Creating an Admin-Extension Object

You may use the HrInstallAdminExtension to create an Admin-Extension object in MS Exchange directory. The following code fragment illustrates the point:

#include <afxwin.h>
#include <MAPIVAL.H>
#include <exchinst.h>

int main( void )
{
    HRESULT hRes = HrInstallAdminExtension( "Rodes",
         "/o=Infowave/ou=Borg",
         "My Extension",
         "MyExt",
         0x00010000,
         0x00000001,
         "MyExt.dll",
         "I386" );
    return ( hRes );
}

Preparing Extension DLL

We need a functional DLL built before we can use it. Writing a DLL itself is a separate task that is described in other topics in this chapter. Having built the DLL you need to put it in the \\SERVER\Add-Ins\<extension-name>\<hardware-platform> directory. For example, if your Exchange server is installed on an Intel machine called MIG and you are installing the extension called MyExt, then you need to create \\MIG\Add-Ins\MyExt\I386 directory and copy MyExt.dll file in there.

Associating a Directory Object with Extension

In order to do it we can use Exchange Administrator in raw mode, obtain the list of existing raw properties and use the displayed dialog to add or modify the Extension-Name attribute. For example, if no extensions are yet associated with our object, then Extension-Name attribute will not be available and we should add it. If there is at least one extension already associated, then we only need to add another name to existing multivalued list.
[ Contents | Home ]