Поделиться через


Метод IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)

Задает массив параметров загрузки, который будет использоваться для создания образа файловой системы. В отличие от IFileSystemImage::p ut_BootImageOptions, этот метод не создает полную копию каждого элемента массива параметров загрузки, а использует ссылки на каждый элемент.

Синтаксис

HRESULT put_BootImageOptionsArray(
  [in] SAFEARRAY *newVal
);

Параметры

[in] newVal

Список интерфейсов IBootOptions образов загрузки, которые будут использоваться для создания образа файловой системы. Каждый элемент списка является variant типа VT_DISPATCH.

Возвращаемое значение

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_NOINTERFACE
Такой интерфейс не поддерживается.

Значение: 0x80004002

IMAPI_E_BOOT_OBJECT_CONFLICT
Загрузочный объект может быть включен только в начальный образ диска.

Значение: 0xC0AAB149

IMAPI_E_BOOT_IMAGE_DATA
Не удалось добавить загрузочный объект в образ.

Значение: 0xC0AAB148

Комментарии

SAFEARRAY должен быть одномерным массивом. Массив нулевого размера разрешен, но это приведет к созданию обычного, не загрузочного диска.

Последовательность загрузочных образов на диске будет соответствовать последовательности, указанной в SAFEARRAY. И put_BootImageOptionsArray , и put_BootImageOptions используются для указания загрузочного образа. Последняя функция вызывается до того, как созданный образ диска вступит в силу.

Функции get_BootImageOptionsArray и get_BootImageOptions извлекают результат последних вызовов put_BootImageOptionsArray или put_BootImageOptions. Использование этих функций должно быть синхронизировано.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header imapi2fs.h

См. также раздел

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray