PrlApi.h

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle was passed.

PRL_ERR_SUCCESS - function completed successfully.

Handles used within the Parallels API are reference counted. Each handle contains a count of the number of references to it held by other objects. A corresponding object stays in memory for as long as the count is greater than zero. A client application is responsible for freeing any handles that are no longer required. A handle can be freed using the PrlHandle_Free function. The function decreases the reference count by one. When the count reaches zero, the object is destroyed. Failing to free a handle after it has been used will result in a memory leak.