ExchangeUtils.CreateMailbox Method

The CreateMailbox(ConnectedMA,ReferenceValue,String,String,long,long,long,Byte[],Boolean) method creates a mailbox in Exchange Server 2000 or Exchange Server 2003 with certain properties, depending on which arguments are supplied.

Syntax

C#
public CSEntry CreateMailbox(
  ConnectedMA TargetADMA,
  ReferenceValue DistinguishedName,
  String Alias,
  String HomeMDB,
  long StoreQuota,
  long OverQuotaLimit,
  long HardLimit,
  Byte[] LogonAccountSID,
  Boolean Exchange2003InetOrgPerson
);
Visual Basic .NET
Public Function CreateMailbox( _
  ByVal TargetADMA As ConnectedMA, _
  ByVal DistinguishedName As ReferenceValue, _
  ByVal Alias As String, _
  ByVal HomeMDB As String, _
  ByVal StoreQuota As long, _
  ByVal OverQuotaLimit As long, _
  ByVal HardLimit As long, _
  ByVal LogonAccountSID As Byte[], _
  ByVal Exchange2003InetOrgPerson As Boolean _
) As CSEntry

Parameters

TargetADMA

The Active Directory management agent through which the new object is provisioned.

DistinguishedName

The distinguished name of the mailbox.

Alias

The mail alias of the mailbox.

HomeMDB

The location of the mailbox store.

StoreQuota

The limit, in kilobytes, to the amount of disk space that the user is allowed to use to store their mail messages. If this quota is exceeded, the user receives a warning message.

OverQuotaLimit

The additional disk space, in kilobytes, that the user gets to store their mail messages. If this quota is exceeded, the user cannot send mail but can receive mail.

HardLimit

The additional disk space, in kilobytes, that the user gets to store their mail messages. If this quota is exceeded, the user can neither send mail nor receive mail.

LogonAccountSID

The security identifier for the account.

Exchange2003InetOrgPerson

Whether the account is an Exchange 2003 Internet account.

Return Value

Returns a CSEntry representing the connected data source entry.

Exceptions

Exception typeCondition
ArgumentException

A required parameter is not present.

ArgumentNullException

A required parameter is null.

ArgumentOutOfRangeException

A limit is too large or too small.

AttributeNotInInclusionListException

A required attribute is not selected in the management agent.

InvalidOperationException

You attempted to create the same custom recipient more than once in the IMVSynchronization.Provision method. This method is called for each metaverse object when a metaverse rules extension exists.

NoSuchObjectTypeException

The object type referenced is not in the schema.

Remarks

To use the default mailbox limits, set StoreQuota, OverQuotaLimit, and HardLimit to 0 (zero).

You can create the following Exchange objects with this method.

ObjectMethod call
Exchange 2000 or Exchange 2003 mailbox CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, 0, 0, 0, null, false)
Exchange 2000 or Exchange 2003 mailbox with limits CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, null, false)
Exchange 2000 or Exchange 2003 resource mailbox CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, 0, 0, 0, LogonAccountSID, false)
Exchange 2000 or Exchange 2003 resource mailbox with limits CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, LogonAccountSID, false)
Exchange 2003 InetOrgPerson with limits CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, LogonAccountSID, true)

Requirements

ProductILM 2007 FP1
NamespaceMicrosoft.MetadirectoryServices
AssemblyMicrosoft.MetadirectoryServices
.NET Framework.NET Framework 2.0

See Also

CSEntry
ExchangeUtils


Send comments about this topic to Microsoft

Build date: 2/16/2009

Tags :


Page view tracker