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
E_NOINTERFACE	Nessuna interfaccia di questo tipo supportata. Valore: 0x80004002
IMAPI_E_BOOT_OBJECT_CONFLICT	Un oggetto di avvio può essere incluso solo in un'immagine disco iniziale. Valore: 0xC0AAB149
IMAPI_E_BOOT_IMAGE_DATA	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

Vedi anche

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray