Share via


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