Compartir a través de

Método IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)

  • Artículo

Establece la matriz de opciones de arranque que se usará para generar la imagen del sistema de archivos. A diferencia de IFileSystemImage::p ut_BootImageOptions, este método no creará una copia completa de cada elemento de matriz de opciones de arranque, sino que usará referencias a cada elemento.

Sintaxis

HRESULT put_BootImageOptionsArray(
  [in] SAFEARRAY *newVal
);

Parámetros

[in] newVal

Lista de interfaces IBootOptions de las imágenes de arranque que se usarán para generar la imagen del sistema de archivos. Cada elemento de la lista es un valor VARIANT del tipo VT_DISPATCH.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_NOINTERFACE
 No se admite dicha interfaz.

Valor: 0x80004002
IMAPI_E_BOOT_OBJECT_CONFLICT
 Un objeto de arranque solo se puede incluir en una imagen de disco inicial.

Valor: 0xC0AAB149
IMAPI_E_BOOT_IMAGE_DATA
 No se pudo agregar el objeto de arranque a la imagen.

Valor: 0xC0AAB148

Comentarios

SAFEARRAY debe ser una matriz unidimensional. Se permite una matriz de tamaño cero, pero dará como resultado un disco normal y no de arranque.

La secuencia de imágenes de arranque del disco coincidirá con la secuencia especificada en SAFEARRAY. Tanto put_BootImageOptionsArray comoput_BootImageOptions se usan para especificar la imagen de arranque, la última función que se invoca antes de que la imagen de disco creada surta efecto.

Las funciones get_BootImageOptionsArray y get_BootImageOptions recuperarán el resultado de las últimas llamadas de put_BootImageOptionsArray o put_BootImageOptions. El uso de estas funciones debe sincronizarse.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray