Error Provider
Raises specific MPF errors and remaps raised errors to other errors with localized descriptions. Used by Microsoft® Provisioning Framework (MPF).
Implementation
Program Files\Microsoft Provisioning\Providers\MPFError.dll
Properties
Name Error Provider Version 1 Provider Source Provisioning.MPFError.1 Procedures
Procedure Description ReportEvent Raises an error to the Microsoft® Windows® application event log. SetError Sets the MPF error variable to the HRESULT and description for the current error and raises it to the Provisioning Engine, which propagates the error back to the calling procedure. TranslateProvisioningError Translates an MPF error raised by a calling procedure and uses a lookup table to translate it into a message that is more meaningful for the current context. For example, this procedure can be used to translate a potentially confusing low-level error to a friendly message. TranslateUserError Translates a user-specified error to another error. Useful when you know the specific error you want to raise. Mainly used for localization. Errors
The following table lists the errors returned by this provider.
HRESULT Description 0x80004005 The XML error map file was not found in \HKEY_LOCAL_MACHINE\Software\Microsoft\Provisioning\Providers\Error Provider\RootFolder. Remarks
Customizing the Provider
Several Microsoft® Windows® registry values allow customization of the provider procedures TranslateProvisioningError and TranslateUserError. These values are located in \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Provisioning\Providers\Error Provider.
Value Description MustHandleError Determines how to resolve errors when a mapping does not exist in a translation lookup file. If set to 1 (true, default), the provider sets the MPF error to a generic error with hr=E_FAIL (0x80004005) and a description of the failed ErrorId from the error database. If set to 0 (false), MPF maintains the original error code and description but changes the error source to "Error Provider". This value corresponds to the request XML's mustHandleError node. (The latter exists only as a backup in case someone deletes the registry key.) Any value defined for the registry key overrides any value specified for the request.
RootFolder Specifies the location of the translation mapping file. To prevent the provider from logging events to the application event log, you can also create the following additional registry entry.
- Key Name: LogEvents
- Registry Value: REG_DWORD, Boolean, 0 = false, 1 = true
See Also
Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.