Handling Errors

When you write a Forefront Identity Manager Synchronization Service (FIM Synchronization Service) extension, be aware that you must consider several exceptions that can be returned from the extension DLL. When these exceptions are thrown, a description string is specified in some cases. This string is visible only for object errors and not for run errors, except where it is logged.

The following sections contain useful information about common exceptions that must be handled for each method.

GenerateImportFile Method Exceptions

The following table contains useful information about common exceptions that must be handled for the GenerateImportFile method.

Exeptions	Step run result	Action	Object error	Log
ServerDownException	stopped-server-down	Stop Run		N
BadServerCredentialsException	stopped-bad-server-credentials	Stop Run		N
ExtensibleExtensionException	stopped-extensible-extension-error	Stop Run		Y
EntryPointNotImplementedException	stopped-entry-point-not-implemented	Stop Run		N
UnexpectedDataException	stopped-unexpected-data	Stop Run		Y
OtherException	stopped-extension-dll-exception	Stop Run		Y

BeginExport Method Exceptions

The following table contains useful information about common exceptions that must be handled for the BeginExport method.

Exeptions	Step run result	Action	Object error	Log
ServerDownException	stopped-server-down	Stop Run		N
BadServerCredentialsException	stopped-bad-server-credentials	Stop Run		N
ExtensibleExtensionException	stopped-extensible-extension-error	Stop Run		Y
EntryPointNotImplementedException	stopped-entry-point-not-implemented	Stop Run		N
UnexpectedDataException	stopped-unexpected-data	Stop Run		Y
OtherException	stopped-extension-dll-exception	Stop Run		Y

ExportEntry Method Exceptions

The following table contains useful information about common exceptions that must be handled for the ExportEntry method.

Exeptions	Step run result	Action	Object error	Log
ServerDownException	completed-export-errors	Continue Run	server-down	N
ExtensibleExtensionException	completed--warnings	Continue Run	extensible-extension-error	Y
EntryPointNotImplementedException	stopped-entry-point-not-implemented	Stop Run		N
UnexpectedDataException	completed-export-errors	Continue Run	extension-unexpected-attribute-value	Y
EntryExportException	completed--warnings	Continue Run	entry-export-error	N
FatalEntryExportException	stopped-entry-export-error	Stop Run		N
OtherException	completed-export-errors	Continue Run	ma-extension-error	Y

EndExport Method Exceptions

The following table contains useful information about common exceptions that must be handled for the EndExport method.

Exeptions	Step run result	Action	Object error	Log
ServerDownException	stopped-server-down	Stop Run		N
ExtensibleExtensionException	stopped-extensible-extension-error	Stop Run		Y
EntryPointNotImplementedException	stopped-entry-point-not-implemented	Stop Run		N
UnexpectedDataException	stopped-unexpected-data	Stop Run		Y
OtherException	stopped-extension-dll-exception	Stop Run		Y

DeliverExportFile Method Exceptions

The following table contains useful information about common exceptions that must be handled for the DeliverExportFile method.

Exeptions	Step run result	Action	Object error	Log
ServerDownException	stopped-server-down	Stop Run		N
BadServerCredentialsException	stopped-bad-server-credentials	Stop Run		N
ExtensibleExtensionException	stopped-extensible-extension-error	Stop Run		Y
EntryPointNotImplementedException	stopped-entry-point-not-implemented	Stop Run		N
UnexpectedDataException	stopped-unexpected-data	Stop Run		Y
OtherException	stopped-extension-dll-exception	Stop Run		Y

See Also

Concepts

Using Forefront Identity Manager Synchronization Service
Creating Rules Extensions