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

Метод IMetaDataDispenserEx::SetOption (rometadataapi.h)

  • Статья

Задает для указанного параметра заданное значение для текущего область метаданных. Параметр управляет обработкой вызовов текущих область метаданных.

Синтаксис

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

Параметры

[in] optionId

Указатель на GUID, указывающий параметр, который необходимо задать.

[in] pValue

Значение, используемое для задания параметра. Тип этого значения должен быть вариантом типа указанного параметра.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

В следующей таблице перечислены доступные идентификаторы GUID, на которые может указывать параметр optionId , и соответствующие допустимые значения для параметра 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 Определяет, должен ли импортер библиотеки типов создавать адаптеры тесно связанных событий (TCE) для контейнеров точек подключения COM. Должен быть вариантом типа BOOL. Если для параметра pValue задано значение true, средство импорта библиотеки типов создает адаптеры TCE.
MetaDataTypeLibImportNamespace Задает пространство имен, отличное от используемого по умолчанию, для импортируемой библиотеки типов. Должно быть значением NULL или вариантом типа BSTR. Если pValue имеет значение NULL, текущее пространство имен имеет значение NULL; В противном случае текущему пространству имен присваивается строка, которая хранится в типе BSTR варианта.
MetaDataLinkerOptions Определяет, должен ли компоновщик создавать сборку или файл модуля платформа .NET Framework. Должен быть вариантом типа UI4 и содержать сочетание значений перечисления CorLinkerOptions .
MetaDataRuntimeVersion Указывает версию среды CLR, на основе которой был создан этот образ. Версия хранится в виде строки, например "v1.0.3705". Должно быть значением NULL, значением VT_EMPTY или вариантом типа BSTR. Если значение pValue равно NULL, версия среды выполнения имеет значение NULL. Если значение pValue VT_EMPTY, для версии устанавливается значение по умолчанию, которое извлекается из версии Mscorwks.dll, в которой выполняется код метаданных. В противном случае для версии среды выполнения устанавливается строка, которая хранится в типе BSTR варианта.
MetaDataMergerOptions Задает параметры для слияния метаданных. Должен быть вариантом типа UI4 и содержать сочетание значений перечисления MergeFlags, описанного в файле CorHdr.h.

Требования

Требование Значение
Целевая платформа Windows
Header rometadataapi.h

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

IMetaDataDispenserEx