cma_alert_restore

Restores the state of general or asynchronous alert delivery.

Syntax

cma_alert_restore( prior);

Argument Data Type Access

prior opaque cma_t_alert_ read state

C Binding

#include 


void
cma_alert_restore (
         cma_t_alert_state   *prior);

Arguments

prior: The prior state of alert delivery (enabled or disabled).

Description

This routine restores the alert delivery state (enabled or disabled) that was saved in the prior argument in a previous call to cma_alert_disable_asynch, cma_alert_disable_ general, or cma_alert_enable_general.

For example, if general delivery of alerts is enabled when you call cma_alert_disable_general, the enabled setting is stored in prior. Subsequently calling cma_alert_restore and passing the prior value returned by cma_alert_disable_general causes the enabled setting to be restored, and general delivery of alerts is again enabled.

This routine is not alertable. Because this routine is not alertable, an alert that is already pending will remain pending after this call returns. If a pending alert should be delivered immediately, follow a call to this routine with a call to an alertable routine such as cma_alert_test.

Note that none of the general run-time routines are safe. None of the DECthreads library routines are safe except cma_alert_restore and pthread_setasynccancel.

Exceptions

cma_e_alert_nesting
cma_e_badparam