PrlBootDev_Remove Function

Removes the boot device from the boot priority list.

Syntax

PRL_RESULT PrlBootDev_Remove(
    PRL_HANDLE hVmBootDev
);

File

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

PrlApi.h, PHT_BOOT_DEVICE