Handling Errors

When you write an extension, be aware that there are several exceptions that can be returned from the extension DLL and that must be considered. When these exceptions are thrown, a description string is specified in some cases. This string will be visible only for object errors and not for run errors, except where logged.

The following table contains useful information on common exceptions that must be handled.

MethodExceptionStep run resultActionObject errorLog
GenerateImportFileServerDownException stopped-server-downStop RunN
BadServerCredentialsException stopped-bad-server-credentialsStop RunN
ExtensibleExtensionException stopped-extensible-extension-errorStop RunY
EntryPointNotImplementedExceptionstopped-entry-point-not-implementedStop RunN
UnexpectedDataExceptionstopped-unexpected-dataStop RunY
OtherException stopped-extension-dll-exceptionStop RunY
BeginExportServerDownException stopped-server-downStop RunN
BadServerCredentialsExceptionstopped-bad-server-credentialsStop RunN
ExtensibleExtensionExceptionstopped-extensible-extension-errorStop RunY
EntryPointNotImplementedExceptionstopped-entry-point-not-implementedStop RunN
UnexpectedDataException stopped-unexpected-dataStop RunY
OtherExceptionstopped-extension-dll-exceptionStop RunY
ExportEntryServerDownExceptioncompleted-export-errorsContinue Runserver-downN
ExtensibleExtensionExceptioncompleted--warningsContinue Runextensible-extension-errorY
EntryPointNotImplementedExceptionstopped-entry-point-not-implementedStop RunN
UnexpectedDataExceptioncompleted-export-errorsContinue Runextension-unexpected-attribute-valueY
EntryExportExceptioncompleted--warningsContinue Run entry-export-errorN
FatalEntryExportExceptionstopped-entry-export-errorStop RunN
OtherExceptioncompleted-export-errorsContinue Run ma-extension-errorY
EndExportServerDownExceptionstopped-server-downStop RunN
ExtensibleExtensionExceptionstopped-extensible-extension-errorStop RunY
EntryPointNotImplementedException stopped-entry-point-not-implementedStop RunN
UnexpectedDataException stopped-unexpected-dataStop RunY
OtherException stopped-extension-dll-exceptionStop RunY
DeliverExportFileServerDownExceptionstopped-server-downStop RunN
BadServerCredentialsExceptionstopped-bad-server-credentialsStop RunN
ExtensibleExtensionException stopped-extensible-extension-errorStop RunY
EntryPointNotImplementedException stopped-entry-point-not-implementedStop RunN
UnexpectedDataException stopped-unexpected-dataStop RunY
OtherException stopped-extension-dll-exceptionStop RunY

Note the logging is in addition to any logging the controller may also do.


Send comments about this topic to Microsoft

Build date: 2/16/2009

Show: