HrInstallAdminExtension

The HrInstallAdminExtension function loads an Admin-Extension object into a site.

Quick Info

Header file: EXCHINST.H
Library: EXCHINST.LIB

HRESULT HrInstallAdminExtension(
  LPSTR lpszServer,      
  LPSTR lpszSiteDN,      
  LPSTR lpszDisplayName, 
  LPSTR lpszCommonName,  
  DWORD i,               
  DWORD dwFileVersionLS, 
  LPSTR lpszExtensionDLL,  
  LPSTR lpszMachineType  
);
 

Parameters

lpszServer
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the name of the server where the Admin-Extension object is installed.
lpszSiteDN
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the distinguished name (DN) of the site where the Admin-Extension object is installed.
lpszDisplayName
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the name of the Admin-Extension object as displayed by the Microsoft Exchange Server Administrator program.

Although the Windows NT service control manager preserves the case of the name that is displayed, comparisons between display names are case-insensitive.

lpszCommonName
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the relative distinguished name (RDN) of the Admin-Extension object. Common names have the following format:

extension-name:hardware-platform

For example, suppose you have an Admin-Extension object called MonNet with an Extension-Name attribute of MonNet. If your platform is Intel, set lpszCommonName to MonNet:i386.

dwFileVersionMS
Input parameter. The high-order 32 bits of the file version number.
dwFileVersionLS
Input parameter. The low-order 32 bits of the file version number.
lpszExtensionDLL
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the file name of the Administrator extension DLL.
lpszMachineType
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the computer type such as i386.

Return Values

See Return Values.

Remarks

For more information on this function, see Installing the Administrator Extension DLL.

See Also

HrAdminExtensionExists, HrGetAdminExtensionVersion, HrRemoveAdminExtension