Microsoft Identity Integration Server 2003 Developer Reference

IMAExtensibleCallExport.EndExport

The IMAExtensibleCallExport.EndExport() method is called at the end of an export run to disconnect the connected directory and to release resources.

Use this method to close connections and release any resources obtained in the IMAExtensibleCallExport.BeginExport(String, String, String, ConfigParameterCollection, TypeDescriptionCollection) method. This method is called even if the IMAExtensibleCallExport.BeginExport(String, String, String, ConfigParameterCollection, TypeDescriptionCollection) method throws an exception.

Implement this method in all types of call-based connected data source extensions. Although this method will not be called from import-only connected data source extensions, an error occurs if this method is not implemented in the extension.

For an import-only connected data source extension, you can implement this method by throwing an EntryPointNotImplementedException exception.

[C#]
public abstract void EndExport();

[Visual Basic .NET]
Public MustOverride Sub EndExport()
Implements IMAExtensibleCallExport.EndExport

Parameters

This method has no parameters.

Return Values

This method has no return values.

Exceptions

Exception type	Condition
EntryPointNotImplementedException	The rules extension does not implement this method. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-entry-point-not-implemented. This exception does not generate an event log entry.
ExtensibleExtensionException	An unexpected error occurs in the extension. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-extensible-extension-error. This exception generates an event log entry.
ServerDownException	The connected directory extension cannot establish a connection to the connected directory. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-server-down. This exception does not generate an event log entry.
UnexpectedDataException	The method receives unexpected data. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-unexpected-data. This exception generates an event log entry.

Remarks

All the exceptions described in this topic stop a run. If the method throws an exception that is not described in this topic, the run continues. If the run stops, the WMI Provider returns the string stopped-extension-dll-exception and generates an event log entry.

If an object is in an unknown state or a resource is called through unmanaged code during an export run, this method will not be called.

Requirements

Product: Microsoft Identity Integration Server 2003 Service Pack 1
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.