IMetaDataDispenser::OpenScope-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Öffnet eine vorhandene Datei auf dem Datenträger und ordnet ihre Metadaten im Arbeitsspeicher zu.

HRESULT OpenScope (
    [in]  LPCWSTR     szScope, 
    [in]  DWORD       dwOpenFlags, 
    [in]  REFIID      riid, 
        [out] IUnknown    **ppIUnk
);

Parameter

szScope
[in] Der Name der zu öffnenden Datei. Die Datei muss CLR-Metadaten (Common Language Runtime) enthalten.
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.

Wenn die Zieldatei keine CLR-Metadaten enthält, schlägt die OpenScope-Methode fehl.

Wenn in .NET Framework, Version 1.0 und Version 1.1, ein mit dwOpenFlags geöffneter Bereich auf ofRead festgelegt wird, kann er freigegeben werden. Das heißt, wenn nachfolgende Aufrufe von OpenScope den Namen einer Datei übergeben, die bereits geöffnet war, wird der vorhandene Bereich wiederverwendet und kein neuer Satz Datenstrukturen erstellt. Aufgrund dieser Freigabe können jedoch Probleme auftreten.

In .NET Framework, Version 2.0, werden mit dwOpenFlags geöffnete und auf ofRead festgelegte Bereiche nicht mehr freigegeben. Verwenden Sie den ofReadOnly-Wert, um die Freigabe des Bereichs zuzulassen. Wenn ein Bereich freigegeben ist, schlagen Abfragen, die "Lese-/Schreib"-Metadatenschnittstellen verwenden, fehl.