Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVm_UnregEventHandler Function
PHT_VIRTUAL_MACHINE

Unregisters an event handler (callback function) that was previously registered using the PrlVm_RegEventHandler function.

Syntax
PRL_RESULT PrlVm_UnregEventHandler(
    PRL_HANDLE hObj, 
    PRL_EVENT_HANDLER_PTR handler, 
    PRL_VOID_PTR userData
);
File

PrlApiVm.h

Parameters

hObj
handler
A pointer to the callback function. This must be the same pointer that was passed to the PrlVm_RegEventHandler when the event handler was registered with the virtual machine.
userData
A pointer to the user data. This must also be the same pointer that was passed to the PrlVm_RegEventHandler when the event handler was registered with the virtual machine.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

Use this function when you no longer want to receive event notifications from the virtual machine. The values of the handler and userData parameter constitute a unique pair which will be used to identify the event handler that will be unregistered. Make sure that you supply the same values as the ones you used when you registered the handler.

Links
© 2021 Parallels International GmbH. All rights reserved.