IMAExtensibleCallExport::EndExport Method

Article
02/16/2009

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 that are 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.

Syntax

public void EndExport();

Public Sub EndExport()
Implements IMAExtensibleCallExport.EndExport

Parameters

This method has no parameters.

Return Value

This method does not return a value.

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.

If IMAExtensibleCallExport.BeginExport(String, String, String, ConfigParameterCollection, TypeDescriptionCollection) throws an exception, IMAExtensibleCallExport.EndExport() is called to release the resources and disconnect the directory. However, in cases where the thread has become blocked or deadlocked, it is not possible to call IMAExtensibleCallExport.EndExport(). In this case, ILM 2007 FP1 terminates the extensions.

Requirements

Product	Microsoft Identity Integration Server 2003 SP1
Namespace	Microsoft.MetadirectoryServices
Assembly	Microsoft.MetadirectoryServices
.NET Framework	.NET Framework 2.0