PrlVm_UnregEventHandler Function

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

Syntax

PRL_RESULT PrlVm_UnregEventHandler(
    PRL_HANDLE hVm, 
    PRL_EVENT_HANDLER_PTR handler, 
    PRL_VOID_PTR userData
);

File

PrlApi.h

Parameters

hVm

A handle of type PHT_VIRTUAL_MACHINE identifying the virtual machine.

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

PrlApi.h , PHT_VIRTUAL_MACHINE