ExchangeUtils.Create55CustomRecipient Method

Creates a custom recipient in Microsoft Exchange Server 5.5.

Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)

Usage

'Usage
Dim TargetExchange55MA As ConnectedMA
Dim DistinguishedName As ReferenceValue
Dim Alias As String
Dim DisplayName As String
Dim SMTPEmail As String
Dim ORAddress As String
Dim returnValue As CSEntry

returnValue = ExchangeUtils.Create55CustomRecipient(TargetExchange55MA, DistinguishedName, Alias, DisplayName, SMTPEmail, ORAddress)

Syntax

'Declaration
Public Shared Function Create55CustomRecipient ( _
    TargetExchange55MA As ConnectedMA, _
    DistinguishedName As ReferenceValue, _
    Alias As String, _
    DisplayName As String, _
    SMTPEmail As String, _
    ORAddress As String _
) As CSEntry
public static CSEntry Create55CustomRecipient (
    ConnectedMA TargetExchange55MA,
    ReferenceValue DistinguishedName,
    string Alias,
    string DisplayName,
    string SMTPEmail,
    string ORAddress
)
public:
static CSEntry^ Create55CustomRecipient (
    ConnectedMA^ TargetExchange55MA, 
    ReferenceValue^ DistinguishedName, 
    String^ Alias, 
    String^ DisplayName, 
    String^ SMTPEmail, 
    String^ ORAddress
)
public static CSEntry Create55CustomRecipient (
    ConnectedMA TargetExchange55MA, 
    ReferenceValue DistinguishedName, 
    String Alias, 
    String DisplayName, 
    String SMTPEmail, 
    String ORAddress
)
public static function Create55CustomRecipient (
    TargetExchange55MA : ConnectedMA, 
    DistinguishedName : ReferenceValue, 
    Alias : String, 
    DisplayName : String, 
    SMTPEmail : String, 
    ORAddress : String
) : CSEntry

Parameters

  • TargetExchange55MA
    The Exchange 5.5 management agent through which the new object is provisioned.
  • DistinguishedName
    The distinguished name of the custom recipient.
  • Alias
    The e-mail alias of the custom recipient.
  • DisplayName
    The name that is displayed for the custom recipient.
  • SMTPEmail
    The SMTP address of the custom recipient.
  • ORAddress
    The primary X.400 address for the recipient.

Return Value

Returns a CSEntry object that represents the connected data source entry.

Exceptions

Exception type Condition
System.ArgumentException

A required parameter is not present.

System.ArgumentNullException

A required parameter is null.

AttributeNotInInclusionListException

A required attribute is not selected in the management agent.

System.InvalidOperationException

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

NoSuchObjectTypeException

The object type that is referenced is not in the schema.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

See Also

Reference

ExchangeUtils Class
ExchangeUtils Members
Microsoft.MetadirectoryServices Namespace
CSEntry Class
ExchangeUtils Class

Other Resources

Example: Exchange 5.5 Custom Recipient