Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlBootDev_Remove Function
PHT_BOOT_DEVICE

Removes the boot device from the boot priority list.

Syntax
PRL_RESULT PrlBootDev_Remove(
    PRL_HANDLE hVmBootDev
);
File

PrlApiVm.h

Parameters

hVmBootDev
A handle of type PHT_BOOT_DEVICE identifying the boot device.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or the device has been removed from the boot list. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

This function permanently removes a devices from the list. If you would like to temporarily disable a device, use the PrlBootDev_SetInUse function. To add a device back to the list, use PrlVmCfg_CreateBootDev and then call the necessary functions of the PHT_BOOT_DEVICE handle to set the necessary properties.

Links
© 2021 Parallels International GmbH. All rights reserved.