Condividi tramite


Metodo IBootOptions::AssignBootImage (imapi2fs.h)

Imposta il flusso di dati che contiene l'immagine di avvio.

Sintassi

HRESULT AssignBootImage(
  [in] IStream *newVal
);

Parametri

[in] newVal

Interfaccia IStream del flusso di dati che contiene l'immagine d'avvio.

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_POINTER
Puntatore non valido.

Valore: 0x80004003

IMAPI_E_BOOT_IMAGE_DATA
Impossibile aggiungere l'oggetto di avvio all'immagine.

Valore: 0xC0AAB142

Commenti

Se le dimensioni dell'immagine di avvio appena assegnata sono 1.2, 1.44. o 2,88 MB, questo metodo regola automaticamente il valore EmulationType sul rispettivo valore di tipo "floppy". È tuttavia possibile eseguire l'override del valore EmulationType predefinito o precedentemente assegnato chiamando il metodo IBootOptions::p ut_Emulation .

La specifica aggiuntiva della piattaforma in cui usare l'immagine di avvio richiede la chiamata al metodo IBootOptions::p ut_PlatformId .

IMAPI non include immagini d'avvio; gli sviluppatori devono fornire le proprie immagini d'avvio.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione imapi2fs.h

Vedi anche

IBootOptions

IBootOptions::get_BootImage

IFileSystemImage::get_BootImageOptions

IFileSystemImage::p ut_BootImageOptions