ADDRTEMP: Installing an Address Entry Template in Active Directory
ADDRTEMP: Installing an Address Entry Template in Active Directory
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release. ADDRTEMP is a new sample application that installs the templates associated with an address type. This application installs templates in Microsoft® Active Directory® using Active Directory® Service Interfaces (ADSI). The ADDRTEMP application replaces TEMPLINST, the template installer used in Microsoft Exchange Server 5.5, which was DAPI-based and installed templates in the Exchange Directory. You can use ADDRTEMP to install templates for entering address types, per-message options, and per-recipient options.
To run ADDRTEMP using the sample text files
- Copy the sample template files from either the EDK or SMTP subdirectories (located in the ADDRTEMP directory) to the directory where AddrTemp.exe is located. AddrTemp.exe will load the values in these files as defaults for its controls. Be sure to first convert .oel and .blt files to .txt files. The application requires this format. For more information about this procedure, see Notes for Using Address Templates, later in this topic.
- At the command prompt, type AddrTemp.exe. The To install a new address template form will display.
- Type your Exchange organization name in the Exchange Organization field.
- Type 409 for the Locale ID. This is the code for English.
- For cn, use EDK or SMTP, depending on the sample template files that you copied in the first step.
- Use the all other default values. Click Install.
The following table describes the ADDRTEMP parameters:
| Parameter | Description |
|---|---|
| Exchange Organization | Name of your Exchange organization. |
| Locale ID | Code for the language in which to install the templates (for example, 409 is English). |
| cn | Name of the address type (for example, EDK). |
| displayName | Template display name. You can choose any name for this value. |
| legacyExchangeDN | The legacy distinguished name for this address template. This is an attribute that is stored for every object in Active Directory. It allows objects to be accessed by Exchange 5.5 servers running in a mixed mode environment, that is, along with Exchange 2000 servers. |
| addressEntryDisplayTable | Contains the name and location of the address entry display table. |
| addressEntryDisplayTableMSDOS | Address entry display table for MS-DOS e-mail clients. |
| addressSyntax | Contains the name and location of file containing the syntax for the address entry template. |
| originalDisplayTable | |
| originalDisplayTableMSDOS | (Binary) Original display table for MS-DOS e-mail clients. |
| perMsgDialogDisplayTable | (Binary) Name and location of the per-message display table. |
| perRecipDialogDisplayTable | (Binary) Name and location of the per-recipient display table. |
The following table provides an example of parameter values to use on the ADDRTEMP form:
Note After you have entered the data, click Load to load the contents of the associated text files. For example, the control named addressEntryDisplayTable is filled with the contents of the addressEntryDisplayTable.txt file. If you have created binary .blt and .oel files, you must use the utility program Bin2Hex, included in the ADDRTEMP directory, to create the text files that ADDRTEMP uses. For more information, see Notes for Using Address Templates, later in this topic. Click Clear if you want to start over and select different files to load. Click Install when you are ready to install the template.
| Parameter Field | Value |
|---|---|
| Exchange Organization | <Your Exchange Organization> |
| Locale ID | 409 |
| cn | EDK |
| displayName | EDK Address |
| legacyExchangeDN | /o=<Your Exchange Organization>/CN=Configuration/CN=Addressing/CN=Address Templates /CN=409/CN=EDK |
| addressEntryDisplayTable | AddressEntryDisplayTable.txt |
| addressEntryDisplayTableMSDOS | |
| addressSyntax | AddressSyntax.txt |
| originalDisplayTable | |
| originalDisplayTableMSDOS | |
| perMsgDialogDisplayTable | perMsgDialogDisplayTable.txt |
| perRecipDialogDisplayTable | perRecipDialogDisplayTable.txt |
Notes for Using Address Templates
Template.exe is included in the ADDRTEMP directory. This file converts a Unicode (.wtx) file for a template to the binary format and saves it as a binary (.blt) file.
You must convert the .oel and .blt files to hexadecimal format before you can use this Microsoft Visual Basic®-based sample application. Use Bin2Hex, a utility program included in the ADDRTEMP directory, to do this. The following is an example:
Bin2Hex EdkAdt.oel addressSyntax.txt Bin2Hex EdkAdt.blt addressEntryDisplayTable.txt
After you have converted them, the .blt and .oel files are no longer needed for this sample application. However, you can use .blt and .oel files in your setup program, read their binary data, and import this data directly into Active Directory. Using these files in your setup program is optional.
For the binary parameters (tables and files), use the same binary data files that were used in Exchange 5.5. These are .blt files (display table files) and .oel files (address syntax). For the sample applications, these must be in hexadecimal format. For more information, see the note, earlier in this topic.
If the .blt files are imported, you can test your address template using the Exchange System Manager.
For more information about address templates, see the following KB article: Q216120: HOWTO: Create and Install a One-Off Address Template.
Send us your feedback about the Microsoft Exchange Server 2003 SDK.
Build: June 2007 (2007.618.1)
© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.