Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlHandle_AddRef Function
Handle Functions  See Also

Increases the specified handle reference count by one.

Syntax
PRL_RESULT PrlHandle_AddRef(
    PRL_HANDLE handle
);
File

PrlApiCore.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.

See Also
Links
© 2021 Parallels International GmbH. All rights reserved.