IMAExtensibleCallExport.EndExport Method

Called at the end of an export run to disconnect the connected directory and to release resources.

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

Usage

'Usage
Dim instance As IMAExtensibleCallExport

instance.EndExport

Syntax

'Declaration
Sub EndExport
void EndExport ()
void EndExport ()
void EndExport ()
function EndExport ()

Exceptions

Exception type Condition
EntryPointNotImplementedException

The rules extension does not implement this method. When this method throws this exception, the run stops and the Windows Management Instrumentation (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 method throws this exception, 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 method throws this exception, 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 method throws this exception, the run stops and the WMI Provider returns the string stopped-unexpected-data.

This exception generates an event log entry.

Remarks

Use this method to close connections and release any resources that are obtained in the BeginExport method. This method is called even if the BeginExport method throws an exception.

Implement this method in all types of call-based connected data source extensions. Although this method is not 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.

All the exceptions that are 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 is not called.

If the BeginExport method throws an exception, the EndExport method is called to release the resources and disconnect the directory. However, when the thread is blocked or deadlocked, it is not possible to call EndExport. In this case, Forefront Identity Manager Synchronization Service (FIM Synchronization Service) terminates the extensions.

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

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003 , Windows Server 2008, and Windows 2000

Target Platforms

See Also

Reference

IMAExtensibleCallExport Interface
IMAExtensibleCallExport Members
Microsoft.MetadirectoryServices Namespace
IMAExtensibleCallExport