Méthode IBootOptions ::AssignBootImage (imapi2fs.h)
Définit le flux de données qui contient l’image de démarrage.
Syntaxe
HRESULT AssignBootImage(
[in] IStream *newVal
);
Paramètres
[in] newVal
Interface IStream du flux de données qui contient l’image de démarrage.
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
| Code de retour | Description |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Impossible d’ajouter l’objet de démarrage à l’image.
Valeur : 0xC0AAB142 |
Remarques
Si la taille de l’image de démarrage nouvellement affectée est 1.2, 1.44. ou 2,88 Mo, cette méthode ajuste automatiquement la valeur EmulationType à la valeur de type « floppy » respective. Toutefois, il est possible de remplacer la valeur EmulationType par défaut ou précédemment affectée en appelant la méthode IBootOptions ::p ut_Emulation .
La spécification supplémentaire de la plateforme sur laquelle utiliser l’image de démarrage nécessite l’appel à la méthode IBootOptions ::p ut_PlatformId .
IMAPI n’inclut aucune image de démarrage ; les développeurs doivent fournir leurs propres images de démarrage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2fs.h |