Metodo IMetaDataDispenser::DefineScope

Articolo
08/11/2011

Crea una nuova area in memoria in cui è possibile creare nuovi metadati.

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

Parametri

rclsid
[in] CLSID della versione delle strutture dei metadati da creare. Questo valore deve essere CLSID_CorMetaDataRuntime per .NET Framework versione 2.0.
dwCreateFlags
[in] Flag che specificano le opzioni. Questo valore deve essere zero per .NET Framework 2.0.
riid
[in] IID dell'interfaccia dei metadati desiderata da restituire. Il chiamante utilizzerà l'interfaccia per creare i nuovi metadati.

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

Note

DefineScope crea un set di tabelle dei metadati in memoria, genera un GUID (identificatore della versione del modulo o MVID) univoco per i metadati e crea una voce nella tabella dei moduli per l'unità di compilazione generata.

È possibile collegare attributi all'intero ambito dei metadati utilizzando il metodo IMetaDataEmit::SetModuleProps o IMetaDataEmit::DefineCustomAttribute, a seconda del caso.