Creating a Mailbox

To create a mailbox for a recipient, create the object for that recipient in the directory. Later, the information store automatically creates a mailbox the first time a person or an application logs on as this recipient (after a MAPI profile has been created) or when someone tries to send mail to the recipient. No separate action is needed to create the object in the information store.

To create a mailbox for a recipient

Create a mailbox object in the directory by calling the DAPIWrite function. You can also use this call to DAPIWrite to create a Windows NT user account. In this function call, pass the pAttributes parameter, which points to a DAPI_ENTRY structure containing names of attributes to write. In this DAPI_ENTRY structure, you need to specify, at minimum, the following attributes:

• The Object-Class, which is the OID of this object's class and (optionally) the OIDs of its superclass.
• The Common-Name, which is the DN of this object. This attribute identifies the object.
• The Home-Server. This may be specified as:

  A specific server.

  — Or—

  The string ~SERVER, which will be replaced with the name of the bound server.

  Although other attributes are required, default values are assigned if you omit them. For example:

• The Display-Name is required for the MAPI address book. If it is not supplied, it is defaulted to the value specified for Common-Name.
• Although the schema requires the Delivery-Mechanism attribute, the DAPIWrite function call creates a default value for this attribute for mailbox objects.