IMetaDataDispenserEx：：SetOption 方法 (rometadataapi.h)
將指定的選項設定為目前中繼資料範圍的指定值。 選項可控制對目前中繼資料範圍之呼叫的處理方式。
語法
HRESULT SetOption(
[in] REFGUID optionId,
[in] const VARIANT *pValue
);
參數
[in] optionId
GUID 的指標，指定要設定的選項。
[in] pValue
要用來設定選項的值。 這個值的類型必須是所指定選項的類型變體。
傳回值
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
下表列出 optionId 參數可以指向的可用 GUID，以及 pValue 參數的對應有效值。
| GUID | 描述 | pValue 參數 |
|---|---|---|
| MetaDataCheckDuplicatesFor | 控制要檢查哪些項目是否有重複。 | 必須是 UI4 型別的變體，而且必須包含 CorCheckDuplicatesFor 列舉值的組合。 |
| MetaDataRefToDefCheck | 控制要將哪些參考的項目轉換成定義。 根據預設，中繼資料引擎會藉由將參考的項目轉換成其定義，來將程式碼最佳化 (如果參考的項目實際上已定義於目前範圍內)。 | 必須是 UI4 型別的變體，而且必須包含 CorRefToDefCheck 列舉值的組合。 |
| MetaDataNotificationForTokenMovement | 控制哪個在中繼資料合併期間發生的語彙基元重新對應會產生回呼。 | 必須是 UI4 型別的變體，而且必須包含 CorNotificationForTokenMovement 列舉值的組合。 |
| MetaDataSetENC | 控制編輯後繼續 (ENC) 的行為。 一次只能設定一種行為模式。 | 必須是 UI4 型別的變體，而且必須包含 CorSetENC 列舉的值。 此值不是位元遮罩。 |
| MetaDataErrorIfEmitOutOfOrder | 控制哪個未依序發出錯誤會產生回呼。 未依序發出中繼資料並非嚴重錯誤；不過，如果您依中繼資料引擎偏好的順序來發出中繼資料，中繼資料會更精簡，而讓您能夠更有效率地搜尋。 | 必須是 UI4 型別的變體，而且必須包含 CorErrorIfEmitOutOfOrder 列舉值的組合。 |
| MetaDataImportOption | 控制列舉程式會擷取哪幾種在 ENC 期間刪除的項目。 | 必須是UI4類型的變體，而且必須包含 CorImportOptions 列舉值的組合。 |
| MetaDataThreadSafetyOptions | 控制中繼資料引擎是否要取得讀取器/寫入器鎖定，進而確保執行緒安全性。 根據預設，引擎會假設存取是由呼叫端以單一執行緒進行，因此不會取得任何鎖定。 用戶端要負責在使用中繼資料 API 時維持適當的執行緒同步處理。 | 必須是 UI4 型別的變體，而且必須包含 CorThreadSafetyOptions 列舉的值。 此值不是位元遮罩。 |
| MetaDataGenerateTCEAdapters | 控制型別程式庫匯入工具是否應該為 COM 連接點容器產生緊密結合的事件 (TCE) 配接器。 | 必須是 BOOL 型別的變體。 如果 pValue 設定為 true，則類型庫匯入工具會產生 TCE 配接器。 |
| MetaDataTypeLibImportNamespace | 指定要匯入之型別程式庫的非預設命名空間。 | 必須是 null 值或 BSTR 型別的變體。 如果 pValue 是 Null 值，則目前的命名空間會設定為 null;否則，目前的命名空間會設定為變數 BSTR 類型中保留的字串。 |
| MetaDataLinkerOptions | 控制連結器是否應該產生元件或 .NET Framework 模組檔案。 | 必須是 UI4 型別的變體，而且必須包含 CorLinkerOptions 列舉值的組合。 |
| MetaDataRuntimeVersion | 指定所建置的這個映像所針對的 Common Language Runtime 版本。 版本會儲存為字串，例如「v1.0.3705」。 | 必須是 null 值、VT_EMPTY 值或 BSTR 型別的變體。 如果 pValue 為 null，運行時間版本會設定為 null。 如果 pValue 是VT_EMPTY，則版本會設定為預設值，這是從元數據程式代碼執行所在的 Mscorwks.dll 版本繪製。 否則，執行階段版本會設定為變體 BSTR 型別中保留的字串。 |
| MetaDataMergerOptions | 指定用於合併中繼資料的選項。 | 必須是UI4類型的變體，而且必須包含 MergeFlags 列舉值的組合，如 CorHdr.h 檔案中所述。 |
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | rometadataapi.h |