Método de IMetaDataDispenser::OpenScopeOnMemory

Artigo
08/08/2011

Abre uma área da memória que contém os metadados existentes. Ou seja, esse método abre uma área especificada de memória na qual os dados existentes são tratados como metadados.

HRESULT OpenScopeOnMemory (
    [in]  LPCVOID     pData, 
    [in]  ULONG       cbData, 
    [in]  DWORD       dwOpenFlags, 
    [in]  REFIID      riid, 
    [out] IUnknown    **ppIUnk
);

Parâmetros

pData
[in] Um ponteiro que especifica o endereço inicial da área de memória.
cbData
[in] O tamanho da área de memória em bytes.
dwOpenFlags
[in] Um valor igual a CorOpenFlags enumeração para especificar o modo (leitura, gravação e assim por diante) para abri-lo.
riid
[in] O IID da interface desejado de metadados a serem retornadas; o chamador usará a interface para importar (ler) ou emitir os metadados (gravação).

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

Comentários

A cópia na memória dos metadados pode ser consultada usando métodos de um dos "Importar" interfaces ou adicionados usando os métodos de um da "emitir" interfaces.

O OpenScopeOnMemory método é semelhante do IMetaDataDispenser::OpenScope método, exceto que os metadados de interesse já existem na memória, em vez de um arquivo no disco.

Se a área de memória de destino não contiver metadados comuns do runtime (CLR) de idioma, o OpenScopeOnMemory método irá falhar.