IMetaDataDispenser::OpenScopeOnMemory-Methode

Artikel
08/10/2011

Öffnet einen Bereich des Arbeitsspeichers, der vorhandene Metadaten enthält. Das heißt, diese Methode öffnet einen angegebenen Bereich des Arbeitsspeichers, in dem die vorhandenen Daten wie Metadaten behandelt werden.

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

Parameter

pData
[in] Ein Zeiger, der die Startadresse des Arbeitsspeicherbereichs angibt.
cbData
[in] Die Größe des Arbeitsspeicherbereichs in Bytes.
dwOpenFlags
[in] Ein Wert der CorOpenFlags-Enumeration, der den Modus zum Öffnen angibt (Lese-, Schreibberechtigung usw.).
riid
[in] Die IID der gewünschten zurückzugebenden Metadatenschnittstelle. Der Aufrufer verwendet die Schnittstelle zum Importieren (Lesen) oder Ausgeben (Schreiben) von Metadaten.

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

Hinweise

Die speicherresidente Kopie der Metadaten kann mit den Methoden der "Importieren"-Schnittstellen abgefragt oder mit den Methoden der "Ausgeben"-Schnittstellen hinzugefügt werden.

Die OpenScopeOnMemory-Methode ähnelt der IMetaDataDispenser::OpenScope-Methode. Die relevanten Metadaten befinden sich jedoch bereits im Arbeitsspeicher und nicht mehr in einer Datei auf einem Datenträger.

Wenn der Zielbereich des Arbeitsspeichers keine Common Language Runtime-Metadaten (CLR) enthält, schlägt die OpenScopeOnMemory-Methode fehl.