IMetaDataDispenser::DefineScope-Methode

Artikel
08/10/2011

Erstellt einen neuen Bereich im Arbeitsspeicher, in dem Sie neue Metadaten erstellen können.

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

Parameter

rclsid
[in] Die CLSID der Version der zu erstellenden Metadatenstrukturen. Dieser Wert muss CLSID_CorMetaDataRuntime für .NET Framework, Version 2.0, sein.
dwCreateFlags
[in] Flags, die Optionen angeben. Dieser Wert muss 0 (null) für .NET Framework 2.0 sein.
riid
[in] Die IID der gewünschten zurückzugebenden Metadatenschnittstelle. Der Aufrufer verwendet die Schnittstelle zum Erstellen der neuen Metadaten.

Der Wert der riid muss eine der "Ausgabe"-Schnittstellen angeben. Gültige Werte sind IID_IMetaDataEmit, IID_IMetaDataAssemblyEmit oder IID_IMetaDataEmit2.
ppIUnk
[out] Der Zeiger auf die zurückgegebene Schnittstelle.

Hinweise

DefineScope erstellt einen Satz von speicherresidenten Metadatentabellen, generiert eine eindeutige GUID (Modulversionsbezeichner oder MVID) für die Metadaten und erstellt einen Eintrag in der Modultabelle für die auszugebende Kompilierungseinheit.

Mit der IMetaDataEmit::SetModuleProps-Methode oder der IMetaDataEmit::DefineCustomAttribute-Methode können Sie Attribute an den Metadatenbereich als Ganzes anfügen.