ADMIN_Initialize

The ADMIN_Initialize function is called by the file-based batch processing functions of the directory access functions to initiate the handshaking between the Microsoft Exchange Server Administrator program and the Administrator extension DLL. Unlike the other user-supplied DLL functions, the Administrator program calls this mandatory Administrator extension DLL function by name, not through a pointer reference. Therefore, this function must have the name ADMIN_Initialize.

Quick Info

Header file: ADMINEXT.H
Library: ADMINEXT.LIB 

VOID ADMIN_Initialize(
  ADMIN_AdministratorConnections * pac,          
  ADMIN_AdministratorFunction * pAdminFunction,  
  ADMIN_ExtensionFunction ** ppExtensionFunction  
);

Parameters

pac
Input parameter. Points to an ADMIN_AdministratorConnections structure containing handles to the MAPI session, the address book, and the address book container opened by the Administrator program.
pAdminFunction
Input parameter. Points to an ADMIN_AdministratorFunction structure containing pointers to the functions available in the Administrator program.
ppExtensionFunction
Output parameter. Points to an ADMIN_ExtensionFunction structure containing pointers to functions in the Administrator extension DLL that are passed to the Administrator program.

Return Values

None.

Remarks

The Microsoft Exchange Server Administrator program calls the Administrator extension DLL in an initial handshake to exchange pointers to the other extension functions. ADMIN_Initialize is the only function that is exported by the Administrator extension DLL.

Because there is no return value, this function must succeed. If an error occurs (such as when an ADMIN_AdministratorConnections or ADMIN_AdministratorFunction member pointer is NULL), the extension DLL must not call the InitSheetProc function to initialize any property sheets.

Typically, this function does little more than save the pointers supplied in the parameters.

For more information on this function, see Using Administrator Extension Functions (Called by Administrator Program).

See Also

CommitDataProc, DeinitSheetProc, DoHelpProc, HasHelpProc, SaveDataProc, ShowPageProc, StartPageProc