PURPOSE

AEWisblocked - determine if a blocking call is in progress

SYNOPSIS

#include <atmi.h>
int far pascal AEWisblocked(void)

DESCRIPTION

AEWisblocked() is an "ATMI Extension for Windows" that allows a Windows task to determine if it is executing while waiting for a previous blocking call to complete.

RETURN VALUES

AEWisblocked() returns 1 if there is an outstanding blocking function awaiting completion. Otherwise, it returns 0.

ERRORS

No errors are returned.

PORTABILITY

This interface is supported only in DOS Windows clients.

COMMENTS

Although a blocking ATMI call appears to an application as though it "blocks", the Windows ATMI DLL has to relinquish the processor to allow other applications to run. This means that it is possible for the application which issued the blocking call to be re-entered, depending on the message(s) it receives. In this instance, the AEWisblocked() function can be used to ascertain whether the task has been re-entered while waiting for an outstanding blocking call to complete. Note that ATMI prohibits more than one outstanding call per thread.

SEE ALSO

AEWsetblock(3c)