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