Rockwell Automation 6182 SDK - Manual (Page 87)

RAC6182-Specific Extensions to the CE API 4–47
Publication 6182-UM002B-EN-P
Remarks
This function unregisters and frees a warning state notification event that
had previously been created using hm_RegisterMonitorWarningEvent.
This function will automatically free hEventHandle, so the application
should not attempt to free it with CloseHandle.
Parameter Description
hEventHandle Handle of the previously registered warning event
that is now being unregistered and freed.
Return Value
Returns TRUE if the monitor warning event has been successfully
unregistered. Returns FALSE on failure.
Portability
This function is specific to the RAC6182 hardware.
See Also
hm_RegisterMonitorWarningEvent
hm_GetMonitorWarnings
This function gets warnings. It is prototyped in HardwareMonitorAPI.h.
Syntax
#include
#include
BOOL hm_GetMonitorWarnings (DWORD *pdwMonitorID)
Remarks
This function returns a bitwise OR'd combination of all monitor sources
that are currently in the warning state. Note that this function does not
latch any previous warning states that may have previously triggered
warning notification events. Therefore, if a monitor source enters a
warning state and triggers a notification event, it is possible that the
monitor has left the warning state before an application calls this
function.
Note: A system shutdown on account of a power failure cannot be
sensed via this call. When the system is in the power fail
shutdown state, communication with the microcontroller
that this function uses to get monitor levels is already
shutdown. To sense power fail an application must use
hm_RegisterMonitorWarningEvent to register an event with
the power fail monitor.