Metodo IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)
Imposta la matrice di opzioni di avvio che verrà utilizzata per generare l'immagine del file system. A differenza di IFileSystemImage::p ut_BootImageOptions, questo metodo non creerà una copia completa di ogni elemento della matrice di opzioni di avvio, ma userà invece riferimenti a ogni elemento.
Sintassi
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
Parametri
[in] newVal
Elenco delle interfacce IBootOptions delle immagini d'avvio che verranno utilizzate per generare l'immagine del file system. Ogni elemento dell'elenco è variant del tipo VT_DISPATCH.
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
Codice restituito | Descrizione |
---|---|
|
Nessuna interfaccia di questo tipo supportata.
Valore: 0x80004002 |
|
Un oggetto di avvio può essere incluso solo in un'immagine disco iniziale.
Valore: 0xC0AAB149 |
|
Impossibile aggiungere l'oggetto di avvio all'immagine.
Valore: 0xC0AAB148 |
Commenti
SAFEARRAY deve essere una matrice unidimensionale. È consentita una matrice di dimensioni zero, ma genererà un normale disco non di avvio.
La sequenza di immagini d'avvio sul disco corrisponderà alla sequenza specificata in SAFEARRAY. Sia put_BootImageOptionsArray cheput_BootImageOptions vengono usati per specificare l'immagine d'avvio, quest'ultima funzione viene richiamata prima che l'immagine del disco creata venga applicata.
Le funzioni get_BootImageOptionsArray e get_BootImageOptions recupereranno il risultato delle ultime chiamate di put_BootImageOptionsArray o put_BootImageOptions. L'uso di queste funzioni deve essere sincronizzato.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista con SP1 [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | imapi2fs.h |