Share via

CSEntry.CommitNewConnector Method

  • Article

Finishes the process of creating a connector and adding it to the ConnectorCollection object. This method is not available in the ExportEntry method.

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

Usage

'Usage
Dim instance As CSEntry

instance.CommitNewConnector

Syntax

'Declaration
Public MustOverride Sub CommitNewConnector

public abstract void CommitNewConnector ()

public:
virtual void CommitNewConnector () abstract

public abstract void CommitNewConnector ()

public abstract function CommitNewConnector ()

Exceptions

Exception type Condition
AttributeNotPresentException

The attributes that contribute to the anchor are not set.
System.InvalidOperationException

The DN property on the new connector has not been set.
MissingParentObjectException

The rules extension tried to add a connector that has a non-existent parent object.
NoCompatiblePartitionFoundException

The rules extension tried to add a connector that does not file the filter criteria for any partitions of the management agent.
ObjectAlreadyExistsException

The rules extension tried to add a connector, but a CSEntry object that has the specified distinguished name already exists in that connector space.

Remarks

After creating the connector with the StartNewConnector method, call this method to add the new connector. If you do not call this method, the object is rolled back to the original attribute values.

Do not call this method when a management agent is in the process of being deleted.

Be aware that the attributes you set on the CSEntry object in the Provision method depend on the data source to which the metaverse entry attributes are exported.

Because different management agents require different (relative) distinguished name (DN) formats, this method handles distinguished names based on the type of management agent. The types are: database management agents, XML without Lightweight Directory Access Protocol (LDAP)–style distinguished names, and the management agents that are neither database nor XML.

Management agent type Distinguished name handling notes

Database

  • The DN property is writable between the calls to the StartNewConnector method and the CommitNewConnector method, and the process may set it.

  • If the DN property is set, the DN is considered a temporary DN.

  • If the DN property is not set, a DN is constructed from anchor attributes. You must add all attributes that contribute to the anchor to the CSEntry object before the call to the CommitNewConnector method. If any of those attributes are not set, an AttributeNotPresentException exception is thrown. The values of the anchor attributes are combined to create the DN for the object. For more information, see EscapeDNComponent.

  • After the CommitNewConnector method is called, the DN property is read-only.

XML

  • The DN property on the new connector is marked as read-only, and therefore the process cannot set it.

  • The DN is constructed from the anchor attributes, and that behavior is exactly the same as the database case.

  • The DN property remains read-only after the call to the CommitNewConnector method.

All other types

  • The DN property on the new connector is writable and must be set before the call to the CommitNewConnector method. If the DN property is not set, the CommitNewConnector method throws an InvalidOperationException exception.

  • The DN property can be modified after the call to the CommitNewConnector method, in which case it is treated as a rename on the object.

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

CSEntry Class
CSEntry Members
Microsoft.MetadirectoryServices Namespace
ConnectorCollection Class
ExportEntry
CSEntry Class