Método de IMetaDataDispenser::DefineScope

Artigo
08/08/2011

Cria uma nova área na memória na qual você pode criar novos metadados.

HRESULT DefineScope (
    [in]  REFCLSID    rclsid,
    [in]  DWORD       dwCreateFlags,
    [in]  REFIID      riid, 
    [out] IUnknown    **ppIUnk
);

Parâmetros

rclsid
[in] O CLSID da versão de estruturas de metadados a serem criados. Este valor deve ser CLSID_CorMetaDataRuntime para o.NET Framework versão 2.0.
dwCreateFlags
[in] Sinalizadores que especificam as opções. Este valor deve ser zero para o.NET Framework 2.0.
riid
[in] O IID da interface desejado de metadados a serem retornadas; o chamador usará a interface para criar novos metadados.

O valor de riid deve especificar um da "emitir" interfaces. Os valores válidos são IID_IMetaDataEmit, IID_IMetaDataAssemblyEmit ou IID_IMetaDataEmit2.
ppIUnk
[out] O ponteiro para a interface retornado.

Comentários

DefineScopecria um conjunto de tabelas de metadados de na memória, gera um GUID exclusivo (identificador de versão do módulo ou MVID) para os metadados e cria uma entrada na tabela de módulo para a unidade de compilação que está sendo emitida.

Você pode anexar atributos para o escopo de metadados como um todo, usando o IMetaDataEmit::SetModuleProps ou IMetaDataEmit::DefineCustomAttribute método, conforme apropriado.