Méthode IFileSystemImage2 ::p ut_BootImageOptionsArray (imapi2fs.h)
Définit le tableau d’options de démarrage qui sera utilisé pour générer l’image du système de fichiers. Contrairement à IFileSystemImage ::p ut_BootImageOptions, cette méthode ne crée pas une copie complète de chaque élément de tableau d’options de démarrage, mais utilise plutôt des références à chaque élément.
Syntaxe
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
Paramètres
[in] newVal
Liste des interfaces IBootOptions des images de démarrage qui seront utilisées pour générer l’image du système de fichiers. Chaque élément de la liste est un VARIANT du type VT_DISPATCH.
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 |
|---|---|
|
Aucune interface de ce type n’est prise en charge.
Valeur : 0x80004002 |
|
Un objet de démarrage ne peut être inclus que dans une image de disque initiale.
Valeur : 0xC0AAB149 |
|
Impossible d’ajouter l’objet de démarrage à l’image.
Valeur : 0xC0AAB148 |
Remarques
LE SAFEARRAY doit être un tableau unidimensionnel. Un tableau de taille nulle est autorisé, mais il aboutira à un disque normal et non démarrable.
La séquence d’images de démarrage sur le disque correspondra à la séquence spécifiée dans le SAFEARRAY. Les deux put_BootImageOptionsArray et put_BootImageOptions sont utilisés pour spécifier l’image de démarrage, cette dernière fonction étant appelée avant que l’image de disque créée ne prenne effet.
Les fonctions get_BootImageOptionsArray et get_BootImageOptions récupèrent le résultat des derniers appels de put_BootImageOptionsArray ou put_BootImageOptions. L’utilisation de ces fonctions doit être synchronisée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista avec SP1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2fs.h |