pfm_rls_cleanup(3ncs)pfm_rls_cleanup(3ncs)Namepfm_rls_cleanup - release clean-up handlers
Syntax
#include <idl/c/base.h>
#include <idl/c/pfm.h>
void pfm_$rls_cleanup(cleanup_record, status)
pfm_$cleanup_rec *cleanup_record;
status_$t *status;
Arguments
cleanup_record The clean-up record for the first clean-up handler
to release.
status The completion status. If status is
pfm_$bad_rls_order, it means that the caller
attempted to release a clean-up handler before
releasing all handlers established after it. This
status is only a warning; the intended clean-up
handler is released, along with all clean-up han‐
dlers established after it. If the completion sta‐
tus returned in is equal to status_$ok, then the
routine that supplied it was successful.
Description
The routine releases the clean-up handler associated with
cleanup_record and all clean-up handlers established after it.
Diagnostics
This section lists the status codes for errors returned by this routine
in
pfm_$bad_rls_order Attempted to release a clean-up handler out of
order.
pfm_$cleanup_not_found
There is no pending clean-up handler.
pfm_$cleanup_set A clean-up handler was established successfully.
pfm_$cleanup_set_signalled
Attempted to use pfm_$cleanup_set as a signal.
pfm_$invalid_cleanup_rec
Passed an invalid clean-up record to a routine.
FilesSee Alsointro(3ncs)pfm_rls_cleanup(3ncs)