Metode IFileSystemImage2::p ut_BootImageOptionsArray (imapi2fs.h)

Mengatur array opsi boot yang akan digunakan untuk menghasilkan gambar sistem file. Tidak seperti IFileSystemImage::p ut_BootImageOptions, metode ini tidak akan membuat salinan lengkap dari setiap elemen array opsi boot, tetapi sebaliknya menggunakan referensi ke setiap elemen.

Sintaks

HRESULT put_BootImageOptionsArray(
  [in] SAFEARRAY *newVal
);

Parameter

[in] newVal

Daftar antarmuka IBootOptions dari gambar boot yang akan digunakan untuk menghasilkan gambar sistem file. Setiap elemen daftar adalah VARIAN dari jenis VT_DISPATCH.

Nilai kembali

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode	Deskripsi
E_NOINTERFACE	Tidak ada antarmuka yang didukung. Nilai: 0x80004002
IMAPI_E_BOOT_OBJECT_CONFLICT	Objek boot hanya dapat disertakan dalam gambar disk awal. Nilai: 0xC0AAB149
IMAPI_E_BOOT_IMAGE_DATA	Objek boot tidak dapat ditambahkan ke gambar. Nilai: 0xC0AAB148

Keterangan

SAFEARRAY harus berupa array satu dimensi. Array ukuran nol diperbolehkan, tetapi akan menghasilkan disk reguler yang tidak dapat di-boot.

Urutan gambar boot pada disk akan cocok dengan urutan yang ditentukan dalam SAFEARRAY. Baik put_BootImageOptionsArray maupun put_BootImageOptions digunakan untuk menentukan gambar boot, fungsi terakhir yang dipanggil sebelum gambar disk yang dibuat berlaku.

Fungsi get_BootImageOptionsArray dan get_BootImageOptions akan mengambil hasil panggilan terakhir put_BootImageOptionsArray atau put_BootImageOptions. Penggunaan fungsi-fungsi ini harus disinkronkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi2fs.h

Lihat juga

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray