CanEventBlock

Determines whether an event type can block during a Report Routine.

Library:LibC
Classification:NetWare OS
Service:NetWare Platform

Syntax

  #include <event.h> 
   
  int CanEventBlock (
     int   type);

Parameters

type

(IN) Specifies an event type (see Event Types).

Return Values

TRUE

The Report Routine can block.

FALSE

The Report Routine cannot block.

Remarks

The CanEventBlock function returns FALSE if the event type is blocking or the calling thread is currently executing in

  • A blocking context (determined by the OS)

  • The debugger

  • An Interrupt Service Routine (ISR)

Otherwise, it returns TRUE.

A consumer of a nonblocking event should use this function when processing an event notification to determine if it is currently safe to block.

See Also