Skip to content

Latest commit

 

History

History
82 lines (64 loc) · 2.95 KB

nf-rometadataapi-imetadatadispenser-openscope.md

File metadata and controls

82 lines (64 loc) · 2.95 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:rometadataapi.IMetaDataDispenser.OpenScope
IMetaDataDispenser::OpenScope (rometadataapi.h)
Opens an existing file from disk, and maps its metadata into memory for reading.
IMetaDataDispenser interface [Windows Runtime]
OpenScope method
IMetaDataDispenser.OpenScope
IMetaDataDispenser::OpenScope
OpenScope
OpenScope method [Windows Runtime]
OpenScope method [Windows Runtime]
IMetaDataDispenser interface
rometadataapi/IMetaDataDispenser::OpenScope
winrt.imetadatadispenser_openscope
winrt\imetadatadispenser_openscope.htm
WinRT
77ba5ee6-082c-478f-83fc-7f6c31ee3c74
12/05/2018
IMetaDataDispenser interface [Windows Runtime],OpenScope method, IMetaDataDispenser.OpenScope, IMetaDataDispenser::OpenScope, OpenScope, OpenScope method [Windows Runtime], OpenScope method [Windows Runtime],IMetaDataDispenser interface, rometadataapi/IMetaDataDispenser::OpenScope, winrt.imetadatadispenser_openscope
rometadataapi.h
Windows
Rometadataapi.idl
Windows
19H1
IMetaDataDispenser::OpenScope
rometadataapi/IMetaDataDispenser::OpenScope
c++
APIRef
kbSyntax
COM
rometadataapi.h
IMetaDataDispenser.OpenScope

-description

Opens an existing file from disk, and maps its metadata into memory for importing (reading).

-parameters

-param szScope [in]

The name of the file to be opened. The file must contain common language runtime (CLR) metadata.

-param dwOpenFlags [in]

Specifies the mode (read, and so on) for opening. This is a value of the CorOpenFlags enumeration. You can only import (read) from the file, not emit (write) to it.

-param riid [in]

The IID of the desired metadata interface to be returned; the caller will use the interface to import (read) metadata.

Valid values for riid include IID_IUnknown, IID_IMetaDataImport, IID_IMetaDataImport2, IID_IMetaDataAssemblyImport, IID_IMetaDataTables, and IID_IMetaDataTables2.

-param ppIUnk [out]

The pointer to the returned interface.

-returns

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

The in-memory copy of the metadata can be queried using methods from one of the "import" interfaces. If the target file doesn't contain CLR metadata, then the OpenScope method will fail.

-see-also

IMetaDataDispenser