Compartilhar via


Método IBootOptions::AssignBootImage (imapi2fs.h)

Define o fluxo de dados que contém a imagem de inicialização.

Sintaxe

HRESULT AssignBootImage(
  [in] IStream *newVal
);

Parâmetros

[in] newVal

Uma interface IStream do fluxo de dados que contém a imagem de inicialização.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_POINTER
O ponteiro não é válido.

Valor: 0x80004003

IMAPI_E_BOOT_IMAGE_DATA
Não foi possível adicionar o objeto de inicialização à imagem.

Valor: 0xC0AAB142

Comentários

Se o tamanho da imagem de inicialização recém-atribuída for 1.2, 1.44. ou 2,88 MB, esse método ajustará automaticamente o valor EmulationType para o respectivo valor de tipo "disquete". No entanto, é possível substituir o valor emulationType padrão ou atribuído anteriormente chamando o método IBootOptions::p ut_Emulation .

A especificação adicional da plataforma na qual usar a imagem de inicialização requer a chamada para o método IBootOptions::p ut_PlatformId .

O IMAPI não inclui nenhuma imagem de inicialização; os desenvolvedores devem fornecer suas próprias imagens de inicialização.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IBootOptions

IBootOptions::get_BootImage

IFileSystemImage::get_BootImageOptions

IFileSystemImage::p ut_BootImageOptions