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 (frees memory used for the address list) for this application, a Mail-Gateway object. | After the routing table is accessed. |
| PADMIN_SetNameList | Saves changes to the routing table for this application, a Mail-Gateway object. 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. |