DosExitMustComplete: Difference between revisions
mNo edit summary |
|||
| Line 2: | Line 2: | ||
==Syntax== | ==Syntax== | ||
DosExitMustComplete(pulNesting) | |||
==Parameters== | ==Parameters== | ||
| Line 18: | Line 9: | ||
==Return Code== | ==Return Code== | ||
;ulrc (APIRET) - returns:DosExitMustComplete returns one of the following values: | |||
DosExitMustComplete returns one of the following values: | * 0 NO_ERROR | ||
* 0 NO_ERROR | *300 ERROR_ALREADY_RESET | ||
* 300 | |||
==Remarks== | ==Remarks== | ||
Latest revision as of 18:03, 15 January 2019
Provides exit from a section of code in which asynchronous exceptions are held.
Syntax
DosExitMustComplete(pulNesting)
Parameters
- pulNesting (PULONG) - output
- Pointer to the nesting level.
- The nesting level is equal to the number of DosEnterMustComplete requests minus the number of DosExitMustComplete requests for the current thread.
Return Code
- ulrc (APIRET) - returns
- DosExitMustComplete returns one of the following values:
- 0 NO_ERROR
- 300 ERROR_ALREADY_RESET
Remarks
Note: Do not make Presentation Manager calls from exception handlers.
DosExitMustComplete notifies the system that the calling thread is leaving a section of code in which any asynchronous exceptions (signals and asynchronous process terminations) that may have occurred were held, rather than being immediately delivered to the thread.
Example Code
This example shows how a thread can notify the system to hold asynchronous exceptions during a section of code.
#define INCL_DOSEXCEPTIONS /* Exception values */
#define INCL_DOSERRORS /* Error values */
#include <os2.h>
#include <stdio.h>
int main(VOID) {
ULONG ulNestLevel = 0; /* Global variable tracking nesting
of DosEnterMustComplete calls */
APIRET rc = NO_ERROR; /* Return code */
rc = DosEnterMustComplete(&ulNestLevel);
if (rc != NO_ERROR) {
printf("DosEnterMustComplete error: return code = %u\n",rc);
return 1;
} else {
printf("ulNestLevel = %u\n",ulNestLevel);
}
/* ADD BLOCK OF CODE THAT MUST COMPLETE HERE... */
rc = DosExitMustComplete(&ulNestLevel);
if (rc != NO_ERROR) {
printf("DosExitMustComplete error: return code = %u\n",rc);
return 1;
} else {
printf("ulNestLevel = %u\n",ulNestLevel);
}
return NO_ERROR;
}