4.15 WFSIsBlocking

BOOL WFSIsBlocking( )

Determines whether a thread has a blocking operation in progress.

Parameters None

Return Value The return value is TRUE if a blocking operation is in progress and FALSE otherwise.

Mode Immediate

Comments Although a call issued on a synchronous (blocking) function appears to an application as though it blocks, the XFS Manager in fact relinquishes control of the processor to allow other Windows processes to run. Thus it is possible for an application that issues a blocking call to be re-entered, depending on the messages it receives. Since the XFS Manager prohibits more than one outstanding blocking call per thread, an application's message processing routines need a way to determine whether they have been re-entered while the application is waiting for an outstanding blocking call to complete. The WFSIsBlocking function provides this function, allowing an application to detect whether a blocking operation is already in progress, before it issues another WOSA/XFS request.

Note that if another WOSA/XFS call is issued in this situation, the XFS Manager returns with a WFS_ERR_OP_IN_PROGRESS error code. See Section 3.12 for additional discussion.

See also WFSCancelBlockingCall