PrlVmCfg_IsRelocateTaskBar Function

Determines if Windows task bar relocation feature is enabled in a virtual machine when it runs in the coherence mode.

Syntax

PRL_RESULT PrlVmCfg_IsRelocateTaskBar(
    PRL_HANDLE hVmCfg, 
    PRL_BOOL_PTR pbVmRelocateTaskBar
);

hVmCfg

A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.

pbVmRelocateTaskBar

[out] A pointer to a variable that receives the result. PRL_TRUE indicates that the feature is enabled. PRL_FALSE indicates otherwise.

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Parallels Tools must be installed to use this feature. To obtain the Parallels Tools status, use the PrlVm_GetToolsState function.