Freigeben über


IBootOptions::AssignBootImage-Methode (imapi2fs.h)

Legt den Datenstrom fest, der das Startimage enthält.

Syntax

HRESULT AssignBootImage(
  [in] IStream *newVal
);

Parameter

[in] newVal

Eine IStream-Schnittstelle des Datenstroms, der das Startimage enthält.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_POINTER
Der Zeiger ist ungültig.

Wert: 0x80004003

IMAPI_E_BOOT_IMAGE_DATA
Das Startobjekt konnte dem Image nicht hinzugefügt werden.

Wert: 0xC0AAB142

Hinweise

Wenn die Größe des neu zugewiesenen Startimages entweder 1.2, 1.44 ist. oder 2,88 MB, passt diese Methode den EmulationType-Wert automatisch an den jeweiligen Wert vom Typ "floppy" an. Es ist jedoch möglich, den Standardwert oder den zuvor zugewiesenen EmulationType-Wert durch Aufrufen der IBootOptions::p ut_Emulation-Methode zu überschreiben.

Die zusätzliche Spezifikation der Plattform, auf der das Startimage verwendet werden soll, erfordert den Aufruf der IBootOptions::p ut_PlatformId-Methode .

IMAPI enthält keine Startimages. Entwickler müssen ihre eigenen Startimages bereitstellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2fs.h

Weitere Informationen

IBootOptions

IBootOptions::get_BootImage

IFileSystemImage::get_BootImageOptions

IFileSystemImage::p ut_BootImageOptions