PrlHandle_AddRef Function

Increases the specified handle reference count by one.

Syntax

PRL_RESULT PrlHandle_AddRef(
    PRL_HANDLE handle
);

File

PrlApi.h

Parameters

handle

Handle to duplicate.

Returns

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Handles used within the Parallels API are thread safe. They can be used in multiple threads at the same time. To maintain the proper reference counting, the count should be increased each time a handle is passed to another thread by calling the PrlHandle_AddRef function. If this is not done, freeing a handle in one thread may destroy it while other threads are still using it.