Microsoft KB Archive/939718

= The MAPI_E_FAILURE error code is generated when you run an application that calls the MAPIFindNext function on a computer that is running Windows Vista =

Article ID: 939718

Article Last Modified on 8/29/2007

-

APPLIES TO


 * Windows Vista Ultimate
 * Windows Vista Business
 * Windows Vista Enterprise
 * Windows Vista Ultimate 64-bit Edition
 * Windows Vista Business 64-bit Edition
 * Windows Vista Enterprise 64-bit Edition

-



SYMPTOMS
If Windows Mail is set as the default e-mail client on a computer that is running Windows Vista, the MAPI_E_FAILURE error code is generated when you run an application that calls the MAPIFindNext function.

Note This function retrieves the next message identifier or the first message identifier of a specified type of incoming message.



Hotfix information
A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.

To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:

http://go.microsoft.com/?linkid=6294451

Note If additional issues occur or any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. To create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

Prerequisites
No prerequisites are required.

Restart requirement
You have to restart the computer after you apply this hotfix.

Hotfix replacement information
This hotfix does not replace any other hotfixes.

Registry information
To use one of the hotfixes in this package, you do not have to make any changes to the registry.

File information
The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

Windows Vista, 64-bit versions




WORKAROUND
To work around this problem, use a Windows Mail API function instead of a simple MAPI function on a Windows Vista-based computer that uses Windows Mail as the default e-mail client.



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section.



MORE INFORMATION
To set Windows Mail as the default e-mail client in Windows Vista, follow these steps:
 * 1) Click Start, and then click Default Programs.
 * 2) Click Set your default programs.
 * 3) In the Programs list, click Windows Mail, click Set this program as default, and then click OK.

For more information about Windows Mail, visit the following Microsoft Web site:

http://msdn2.microsoft.com/en-us/library/ms709546.aspx

For more information about Simple MAPI, visit the following Microsoft Web site:

http://msdn2.microsoft.com/en-us/library/ms529053.aspx

For more information about the MAPIFindNext function, visit the following Microsoft Web site:

http://msdn2.microsoft.com/en-us/library/ms528939.aspx

For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:

824684Description of the standard terminology that is used to describe Microsoft software updates

Keywords: kbbug kbfix kbqfe kbpubtypekc kbexpertiseadvanced kbhotfixserver KB939718

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.