Using Administrator Extension Functions (Called by Extension DLL)

Platform SDK: Exchange Server

Using Administrator Extension Functions (Called by Extension DLL)

The following table lists functions found in the ADMIN_AdministratorFunction structure that is passed as a parameter to your ADMIN_Initialize function. These functions are implemented by the Administrator program and can be called from the Administrator extension DLL:

Administrator Extension Functions (Called by Extension DLL)

Function	Purpose	When to call
PADMIN_GetObjectDataSize	Returns the size in bytes of the Extension-Data attribute associated with a given owner tag. Use this function to determine how much memory to allocate for creating a copy of the Extension-Data attribute.	Before reading extension data out of the directory object, such as during initialization when your property page receives the WM_INITDIALOG message.
PADMIN_GetObjectData	Copies the contents of the Extension-Data attribute associated with a given owner tag.	When you need to read extension data out of the directory object, such as during initialization when your property page receives the WM_INITDIALOG message.
PADMIN_SetObjectData	Writes a block of data to the directory object's Extension-Data attribute. Does not automatically add an owner tag to the binary data block: this is the developer's responsibility. The configuration functions support the addition of owner tags to the structure binary block they create.	When the CommitDataProc function is called.
PADMIN_AddService	Directs the Administrator program to add a service to the list of monitored services.	At any time.
PADMIN_RemoveService	Directs the Administrator program to remove a service from the list of monitored services.	At any time.
PADMIN_InfoHasChanged	Signals the Administrator program to enable the Apply button.	When property page information is changed.
PADMIN_SetIcon	Supplies the control identifier for the standard property page icon to the Administrator program.	When your dialog box receives the WM_INITDIALOG message.
PADMIN_SetTitle	Supplies the control identifier for the standard property page title to the Administrator program.	When your dialog box receives the WM_INITDIALOG message.
PADMIN_GetNameList	Gets the routing table (the address list) of this application.	When access to the routing table is needed.
PADMIN_FreeNameList	Frees the routing table and frees memory used for the address list) for this application.	After the routing table is accessed.
PADMIN_SetNameList	Saves changes to the routing table for this application. Also causes the Address Space property page to be updated with these changes.	As routing table information is accessed.
PADMIN_LoadDialogResource	Loads a dialog-box resource from the DLL for a given language and sets its font to match that used by Admin.	Before displaying any child dialog boxes of a property page.
PADMIN_FreeDialogResource	Deletes a dialog-box resource allocated by PADMIN_LoadDialogResource.	When you have finished using the child dialog box.