Microsoft Identity Integration Server 2003 Developer Reference

IMAExtensibleCallExport.BeginExport

The IMAExtensibleCallExport.BeginExport(String, String, String, ConfigParameterCollection, TypeDescriptionCollection) method is called at the start of an export run to connect to the connected directory and other resources.

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 BeginExport(
  String connectTo,
  String user,
  String password,
  ConfigParameterCollection configParameters,
  TypeDescriptionCollection types
);
[Visual Basic .NET]
Public MustOverride Sub BeginExport( _
  ByVal connectTo As String, _
  ByVal user As String, _
  ByVal password As String, _
  ByVal configParameters As ConfigParameterCollection, _
  ByVal types As TypeDescriptionCollection _
)
Implements IMAExtensibleCallExport.BeginExport

Parameters

connectTo
The name of the connected directory. This value comes from the Connect To text box of the Configure Connection Information dialog box of the extensible connectivity management agent properties.
user
The user name of the account with the appropriate privileges for the connected directory. This value comes from the User text box of the Configure Connection Information dialog box in the extensible connectivity management agent properties.
password
The password of the account with the appropriate privileges for the connected directory. This value comes from the Password text box of the Configure Connection Information dialog box in the extensible connectivity management agent properties.
configParameters
The parameters and values configured in the Configure Additional Parameters dialog box of the extensible connectivity management agent properties.
types
A TypeDescriptionCollection object that contains a collection of TypeDescription objects.

Return Values

This method has no return values.

Exceptions

Exception type Condition
BadServerCredentialsException The credentials that are used to connect to the connected directory are not valid. When this exception is thrown by this method, the run stops and the WMI Provider returns the string stopped-bad-server-credentials

This exception does not generate an event log entry.

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 received 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.

All data in MIIS uses the Unicode character set. If the connected data source that receives the exported data requires data in a different character set, use this method to convert the Unicode data to the character set that is required by your connected data source.

The IMAExtensibleCallExport.ExportEntry(ModificationType, String[], CSEntry) method is called if this method does not throw an exception. When an exception is thrown, the IMAExtensibleCallExport.EndExport() is then 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.

See Also

ConfigParameterCollection, IMAExtensibleCallExport.ExportEntry(ModificationType, String[], CSEntry), IMAExtensibleCallExport.EndExport(), TypeDescriptionCollection