Metodo IMetaDataDispenser::OpenScopeOnMemory

Articolo
08/11/2011

Apre un'area di memoria in cui sono contenuti i metadati esistenti. In altri termini, questo metodo apre una determinata area di memoria nella quale i dati esistenti vengono trattati come metadati.

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

Parametri

pData
[in] Puntatore che specifica l'indirizzo iniziale dell'area di memoria.
cbData
[in] Dimensione dell'area di memoria in byte.
dwOpenFlags
[in] Valore dell'enumerazione CorOpenFlags per specificare la modalità (lettura, scrittura e così via) di apertura.
riid
[in] IID dell'interfaccia dei metadati desiderata da restituire. Il chiamante utilizzerà l'interfaccia per importare (leggere) o generare (scrivere) i metadati.

Il valore di riid deve specificare una delle interfacce di "importazione" o "generazione". I valori validi sono IID_IMetaDataEmit, IID_IMetaDataImport, IID_IMetaDataAssemblyEmit, IID_IMetaDataAssemblyImport, IID_IMetaDataEmit2 e IID_IMetaDataImport2.
ppIUnk
[out] Puntatore all'interfaccia restituita.

Note

La copia in memoria dei metadati può essere sottoposta a query utilizzando i metodi di una delle interfacce di "importazione" oppure essere aggiunta utilizzando i metodi di una delle interfacce di "generazione".

Il metodo OpenScopeOnMemory è simile al metodo IMetaDataDispenser::OpenScope, con la differenza che i metadati di interesse già sono presenti in memoria, anziché in un file su disco.

Se nell'area di memoria di destinazione non sono contenuti metadati di Common Language Runtime, il metodo OpenScopeOnMemory avrà esito negativo.