Метод IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)
Задает массив параметров загрузки, который будет использоваться для создания образа файловой системы. В отличие от IFileSystemImage::p ut_BootImageOptions, этот метод не создает полную копию каждого элемента массива параметров загрузки, а использует ссылки на каждый элемент.
Синтаксис
HRESULT put_BootImageOptionsArray(
[in] SAFEARRAY *newVal
);
Параметры
[in] newVal
Список интерфейсов IBootOptions образов загрузки, которые будут использоваться для создания образа файловой системы. Каждый элемент списка является variant типа VT_DISPATCH.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
Код возврата | Описание |
---|---|
|
Такой интерфейс не поддерживается.
Значение: 0x80004002 |
|
Загрузочный объект может быть включен только в начальный образ диска.
Значение: 0xC0AAB149 |
|
Не удалось добавить загрузочный объект в образ.
Значение: 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 |