IFileSystemImage2::p ut_BootImageOptionsArray-Methode (imapi2fs.h)
Legt das Startoptionsarray fest, das zum Generieren des Dateisystemimages verwendet wird. Im Gegensatz zu IFileSystemImage::p ut_BootImageOptions erstellt diese Methode keine vollständige Kopie jedes Startoptionenarrayelements, sondern verwendet stattdessen Verweise auf jedes Element.
Syntax
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
Parameter
[in] newVal
Liste der IBootOptions-Schnittstellen der Startimages , die zum Generieren des Dateisystemimages verwendet werden. Jedes Element der Liste ist ein VARIANT-Element vom Typ VT_DISPATCH.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Diese Schnittstelle wird nicht unterstützt.
Wert: 0x80004002 |
|
Ein Startobjekt kann nur in ein anfängliches Datenträgerimage eingeschlossen werden.
Wert: 0xC0AAB149 |
|
Das Startobjekt konnte dem Image nicht hinzugefügt werden.
Wert: 0xC0AAB148 |
Hinweise
SafeARRAY muss ein eindimensionales Array sein. Ein Array der Größe Null ist zulässig, führt aber zu einem regulären, nicht startbaren Datenträger.
Die Startimagesequenz auf dem Datenträger entspricht der in SAFEARRAY angegebenen Sequenz. Sowohl put_BootImageOptionsArray als auch put_BootImageOptions werden zum Angeben des Startimages verwendet. Die letztere Funktion wird aufgerufen, bevor das erstellte Datenträgerimage wirksam wird.
Die funktionen get_BootImageOptionsArray und get_BootImageOptions rufen das Ergebnis der letzten Aufrufe von put_BootImageOptionsArray oder put_BootImageOptions ab. Die Verwendung dieser Funktionen sollte synchronisiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista mit SP1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2fs.h |