Skip to content

Latest commit

 

History

History
121 lines (91 loc) · 3.69 KB

nf-imapi2fs-ibootoptions-assignbootimage.md

File metadata and controls

121 lines (91 loc) · 3.69 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:imapi2fs.IBootOptions.AssignBootImage
IBootOptions::AssignBootImage (imapi2fs.h)
Sets the data stream that contains the boot image.
AssignBootImage
AssignBootImage method [IMAPI]
AssignBootImage method [IMAPI]
IBootOptions interface
IBootOptions interface [IMAPI]
AssignBootImage method
IBootOptions.AssignBootImage
IBootOptions::AssignBootImage
imapi.ibootoptions_assignbootimage
imapi2fs/IBootOptions::AssignBootImage
imapi\ibootoptions_assignbootimage.htm
imapi
63d598dd-72a8-4544-813d-11f2e7e53ec5
12/05/2018
AssignBootImage, AssignBootImage method [IMAPI], AssignBootImage method [IMAPI],IBootOptions interface, IBootOptions interface [IMAPI],AssignBootImage method, IBootOptions.AssignBootImage, IBootOptions::AssignBootImage, imapi.ibootoptions_assignbootimage, imapi2fs/IBootOptions::AssignBootImage
imapi2fs.h
Windows
Windows Vista, Windows XP with SP2 [desktop apps only]
Windows Server 2003 [desktop apps only]
Imapi2fs.idl
Windows
19H1
IBootOptions::AssignBootImage
imapi2fs/IBootOptions::AssignBootImage
c++
APIRef
kbSyntax
COM
imapi2fs.h
IBootOptions.AssignBootImage

IBootOptions::AssignBootImage

-description

Sets the data stream that contains the boot image.

-parameters

-param newVal [in]

An IStream interface of the data stream that contains the boot image.

-returns

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
E_POINTER
Pointer is not valid.

Value: 0x80004003

IMAPI_E_BOOT_IMAGE_DATA
The boot object could not be added to the image.

Value: 0xC0AAB142

-remarks

If the size of the newly assigned boot image is either 1.2, 1.44. or 2.88 MB, this method will automatically adjust the EmulationType value to the respective "floppy" type value. It is, however, possible to override the default or previously assigned EmulationType value by calling the IBootOptions::put_Emulation method.

The additional specification of the platform on which to use the boot image requires the call to the IBootOptions::put_PlatformId method.

IMAPI does not include any boot images; developers must provide their own boot images.

-see-also

IBootOptions

IBootOptions::get_BootImage

IFileSystemImage::get_BootImageOptions

IFileSystemImage::put_BootImageOptions