An update lets you choose to execute or bypass the pthread_testcancel function in Subsystem for UNIX-based Applications on Windows Server 2003 R2-based computers

An update is available for Subsystem for UNIX-based Applications (SUA) on Windows Server 2003 R2-based computers. After you apply this update, when you call the pthread_testcancel function in a program, you can set a cancel state value that instructs the function to execute or return immediately.

This update introduces the following functions:

• int setpthreadtestcancelstate(int testCancelState)

  
  The setpthreadtestcancelstate function sets the cancel state, depending on the testCancelState parameter. If the testCancelState parameter is set to 0, the pthread_testcancel function returns immediately without doing any operations. If the testCancelState parameter is set to 1, the pthread_testcancel function is executed.

• int getpthreadtestcancelstate()

  
  The getpthreadtestcancelstate function displays the current cancel state.

Update information

A supported feature that modifies the default behavior of the product is available from Microsoft. However, this feature is intended to modify only the behavior that this article describes. Apply this feature only to systems that specifically require it. This feature might receive additional testing. Therefore, if the system is not severely affected by the lack of this feature, we recommend that you wait for the next software update that contains this feature.

If the feature is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the feature.

Note If additional issues occur or if 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 feature. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site: Note The "Hotfix download available" form displays the languages for which the feature is available. If you do not see your language, it is because the feature is not available for that language.

Prerequisites

To apply this update, you must have Windows Server 2003 Service Pack 2 installed on the computer. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

Installation instructions

This hotfix includes a Windows Server 2003 R2 package and a Utilities and SDK for R2 package. Install the Windows Server 2003 R2 package on all Windows Server 2003 R2-based computers on which you want to run applications that are enabled with the new functionality. Install the Utilities and SDK for R2 package only if you want to develop SUA-based applications that use the new functionality.

To install the Utilities and SDK for R2 package, follow these steps:

1. In the 32-bit environment, execute the R2SUASDK-KB957501-X86-ENU.exe file. In the x64 environment, execute the R2SUASDK-KB956548-AMD64-ENU.exe file.
2. In the Welcome to the Utilities and SDK for UNIX-based Applications Maintenance Wizard window, click Next.
3. Click the Repair or reinstall option, and then click Next.
4. Click the Repair option, and then click Next.
5. In the Completing the Utilities and SDK for UNIX-based Applications Maintenance Wizard dialog box, click Finish.

Note The installation package (Setup.msi) from the Utilities and SDK for UNIX-based Applications is required to successfully complete these steps.

Restart requirement

You must restart the computer after you apply this update.

Update replacement information

This update does not replace any other updates.

File information

The English version of this update 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 Server 2003 with Service Pack 2, x86-based versions

Windows Server 2003 with Service Pack 2, x64-based versions

Utilities and SDK for R2, x86-based version

Utilities and SDK for R2, x64-based version

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