Método IMetaDataDispenser::OpenScopeOnMemory

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

Sintaxe

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 da enumeração CorOpenFlags para especificar o modo (leitura, gravação e assim por diante) para abertura.

riid
[in] A IID da interface de metadados desejada a ser retornada; o chamador usará a interface para importar (ler) ou emitir metadados (gravação).

O valor de riid deve especificar uma das interfaces "import" ou "emit". Os valores válidos são IID_IMetaDataEmit, IID_IMetaDataImport, IID_IMetaDataAssemblyEmit, IID_IMetaDataAssemblyImport, IID_IMetaDataEmit2 ou IID_IMetaDataImport2.

ppIUnk
[out] O ponteiro da interface retornada.

Comentários

A cópia na memória dos metadados pode ser consultada usando métodos de uma das interfaces de "importação" ou adicionada ao uso de métodos de uma das interfaces "emit".

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

Se a área de destino da memória não contiver metadados clr (common language runtime), o método OpenScopeOnMemory falhará.

Requisitos

Plataforma: ver requisitos do sistema.

Cabeçalho: Cor.h

Biblioteca: usada como um recurso na MsCorEE.dll

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também