Metode IMetaDataDispenserEx::SetOption (rometadataapi.h)

Artikel
03/08/2023

Menetapkan opsi yang ditentukan ke nilai tertentu untuk cakupan metadata saat ini. Opsi mengontrol cara panggilan ke cakupan metadata saat ini ditangani.

Sintaks

HRESULT SetOption(
  [in] REFGUID       optionId,
  [in] const VARIANT *pValue
);

Parameter

[in] optionId

Penunjuk ke GUID yang menentukan opsi yang akan diatur.

[in] pValue

Nilai yang digunakan untuk mengatur opsi. Jenis nilai ini harus merupakan varian dari jenis opsi yang ditentukan.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Tabel berikut mencantumkan GUID yang tersedia yang dapat ditujukan oleh parameter optionId dan nilai valid terkait untuk parameter pValue .

GUID	Deskripsi	pValue Parameter
MetaDataCheckDuplicatesFor	Mengontrol item mana yang diperiksa duplikatnya.	Harus merupakan varian jenis UI4, dan harus berisi kombinasi nilai enumerasi CorCheckDuplicatesFor.
MetaDataRefToDefCheck	Mengontrol item yang direferensikan yang akan dikonversi ke definisi. Secara default, mesin metadata akan mengoptimalkan kode dengan mengonversi item yang direferensikan ke definisinya jika item yang direferensikan sebenarnya ditentukan dalam cakupan saat ini.	Harus merupakan varian jenis UI4, dan harus berisi kombinasi nilai enumerasi CorRefToDefCheck.
MetaDataNotificationForTokenMovement	Mengontrol pemetaan ulang token mana yang terjadi selama penggabungan metadata menghasilkan panggilan balik.	Harus merupakan varian jenis UI4, dan harus berisi kombinasi nilai enumerasi CorNotificationForTokenMovement.
MetaDataSetENC	Mengontrol perilaku edit-and-continue (ENC). Hanya dapat menetapkan satu mode perilaku pada satu waktu.	Harus merupakan varian jenis UI4, dan harus berisi nilai enumerasi CorSetENC. Nilainya bukan berupa bitmask.
MetaDataErrorIfEmitOutOfOrder	Kontrol yang memancarkan kesalahan out-of-order menghasilkan panggilan balik. Memancarkan metadata secara tidak berurutan tidak bersifat fatal; namun, jika Anda memancarkan metadata dalam urutan yang dipilih oleh mesin metadata, metadata akan menjadi lebih ringkas dan oleh karena itu dapat dicari dengan lebih efisien.	Harus merupakan varian jenis UI4, dan harus berisi kombinasi nilai enumerasi CorErrorIfEmitOutOfOrder.
MetaDataImportOption	Mengontrol jenis item yang dihapus selama ENC diambil oleh enumerator.	Harus merupakan varian tipe UI4, dan harus berisi kombinasi nilai enumerasi CorImportOptions .
MetaDataThreadSafetyOptions	Mengontrol apakah mesin metadata memperoleh kunci pembaca/penulis, sehingga dapat memastikan keamanan utas. Secara default, mesin mengasumsikan bahwa akses dilakukan dengan utas tunggal oleh penelepon, sehingga tidak ada kunci yang diperoleh. Klien bertanggung jawab untuk memelihara sinkronisasi utas yang tepat saat menggunakan API metadata.	Harus merupakan varian jenis UI4, dan harus berisi nilai enumerasi CorThreadSafetyOptions. Nilainya bukan berupa bitmask.
MetaDataGenerateTCEAdapters	Mengontrol apakah pengimpor pustaka tipe harus menghasilkan adapter peristiwa yang digabungkan dengan erat (TCE) untuk kontainer titik koneksi COM.	Harus berupa varian jenis BOOL. Jika pValue diatur ke true, pengimpor pustaka jenis menghasilkan adaptor TCE.
MetaDataTypeLibImportNamespace	Menentukan namespace layanan non-default untuk pustaka tipe yang sedang diimpor.	Harus berupa nilai null atau varian jenis BSTR. Jika pValue adalah nilai null, namespace saat ini diatur ke null; jika tidak, namespace saat ini diatur ke string yang disimpan dalam jenis BSTR varian.
MetaDataLinkerOptions	Mengontrol apakah penaut harus menghasilkan assembly atau file modul .NET Framework.	Harus merupakan varian jenis UI4, dan harus berisi kombinasi nilai enumerasi CorLinkerOptions.
MetaDataRuntimeVersion	Menentukan versi runtime bahasa umum tempat gambar ini dibuat. Versi disimpan sebagai string, seperti "v1.0.3705".	Harus berupa nilai null, nilai VT_EMPTY, atau varian jenis BSTR. Jika pValue null, versi runtime diatur ke null. Jika pValue VT_EMPTY, versi diatur ke nilai default, yang diambil dari versi Mscorwks.dll tempat kode metadata berjalan. Jika tidak, versi runtime bahasa umum diatur ke string yang disimpan dalam jenis BSTR varian.
MetaDataMergerOptions	Menentukan opsi untuk menggabungkan metadata.	Harus merupakan varian tipe UI4, dan harus berisi kombinasi nilai enumerasi MergeFlags, yang dijelaskan dalam file CorHdr.h.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	rometadataapi.h

Lihat juga

IMetaDataDispenserEx

Bagikan melalui