This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pm_valid_hdl()

Verify handle to a power managed object

Synopsis:

#include <sys/pm.h>

int pm_valid_hdl(pm_hdl_t hdl);

Arguments:

hdl: Handle to the power managed object -- obtained via pm_attach().

Library:

libpm

Description:

The pm_valid_hdl() verifies if the supplied handle is a valid handle to a power managed object.

Returns:

A non-zero value: hdl is a valid handle.
0: hdl is not a valid handle.

Examples:

#include <sys/pm.h>
#include <fcntl.h>
#include <stdlib.h>

int
main()
{
   pm_hdl_t  hdl;

   // attach to object with read-only access
   hdl = pm_attach("object", O_RDONLY);
   if (!pm_valid_hdl(hdl)) {
   perror("pm_attach");
      }
   return EXIT_SUCCESS;
}

Classification:

Neutrino

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes