HrInstallAddressType

The HrInstallAddressType function loads an address type object into a site.

Quick Info

Header file: EXCHINST.H
Library: EXCHINST.LIB

HRESULT HrInstallAddressType(
  LPSTR lpszServer,      
  LPSTR lpszSiteDN,      
  LPSTR lpszDisplayName, 
  LPSTR lpszServiceName, 
  LPSTR lpszCommonName,  
  DWORD dwFileVersionMS, 
  DWORD dwFileVersionLS, 
  LPSTR lpszProxyGenDLL, 
  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 address type 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 address type is installed.
lpszDisplayName
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the name of the address type 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.

lpszServiceName
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the name of the address type which is installed. You cannot use either the forward slash (/) or back slash (\) character in a service name.
lpszCommonName
Input parameter. Points to a null-terminated string containing the relative distinguished name (RDN) of the address type object. Common names have the following format:

extension-name:hardware-platform

For example, suppose you have an address template called Net with an Extension-Name attribute of Net. If your platform is Intel, set lpszCommonName to Net: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.
lpszProxyGenDLL
Input parameter. Points to a null-terminated string (with a maximum length of 256 characters) that contains the full path to the proxy generation DLL file.
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.

See Also

HrAddressTypeExists, HrGetAddressTypeVersion, HrInstallGateway, HrRemoveAddressType