Método IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)
Define a matriz de opções de inicialização que será utilizada para gerar a imagem do sistema de arquivos. Ao contrário de IFileSystemImage::p ut_BootImageOptions, esse método não criará uma cópia completa de cada elemento de matriz de opções de inicialização, mas usará referências a cada elemento.
Sintaxe
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
Parâmetros
[in] newVal
Lista de interfaces IBootOptions das imagens de inicialização que serão utilizadas para gerar a imagem do sistema de arquivos. Cada elemento da lista é um VARIANT do tipo VT_DISPATCH.
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 geralmente 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 |
|---|---|
|
Não há suporte para essa interface.
Valor: 0x80004002 |
|
Um objeto de inicialização só pode ser incluído em uma imagem de disco inicial.
Valor: 0xC0AAB149 |
|
Não foi possível adicionar o objeto de inicialização à imagem.
Valor: 0xC0AAB148 |
Comentários
O SAFEARRAY deve ser uma matriz unidimensional. Uma matriz de tamanho zero é permitida, mas resultará em um disco regular não inicializável.
A sequência de imagens de inicialização no disco corresponderá à sequência especificada no SAFEARRAY. Tanto put_BootImageOptionsArray quanto put_BootImageOptions são usados para especificar a imagem de inicialização, a última função que está sendo invocada antes que a imagem de disco criada entre em vigor.
As funções get_BootImageOptionsArray e get_BootImageOptions recuperarão o resultado das últimas chamadas de put_BootImageOptionsArray ou put_BootImageOptions. O uso dessas funções deve ser sincronizado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2fs.h |