IBootOptions::put_Emulation method (imapi2fs.h)

Sets the media type that the boot image is intended to emulate.

Syntax

HRESULT put_Emulation(
  [in] EmulationType newVal
);

Parameters

[in] newVal

Media type that the boot image is intended to emulate. For possible values, see the EmulationType enumeration type. The default value is EmulationNone, which means the BIOS will not emulate any device type or special sector size for the CD during boot from the CD.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
IMAPI_E_BOOT_EMULATION_IMAGE_SIZE_MISMATCH
The emulation type requested does not match the boot image size.

Value: 0xC0AAB14A

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2fs.h

See also

IBootOptions

IBootOptions::get_Emulation