IMetaDataDispenser::OpenScopeOnMemory, méthode

Article
08/10/2011

Ouvre une zone de mémoire qui contient les métadonnées existantes. Autrement dit, cette méthode ouvre une zone de mémoire spécifiée dans laquelle les données existantes sont considérées comme des métadonnées.

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

Paramètres

pData
[in] Pointeur qui spécifie l'adresse de départ de la zone de mémoire.
cbData
[in] Taille, en octets, de la zone de mémoire.
dwOpenFlags
[in] Valeur de l'énumération CorOpenFlags permettant de spécifier le mode (lecture, écriture, etc.) pour l'ouverture.
riid
[in] L'IID de l'interface de métadonnées voulue à retourner ; l'appelant utilisera cette interface pour importer (lecture) ou émettre (écriture) les métadonnées.

La valeur de riid doit spécifier l'une des interfaces d'importation ou d'émission. Les valeurs valides sont IID_IMetaDataEmit, IID_IMetaDataImport, IID_IMetaDataAssemblyEmit, IID_IMetaDataAssemblyImport, IID_IMetaDataEmit2 ou IID_IMetaDataImport2.
ppIUnk
[out] Pointeur vers l'interface retournée.

Notes

La copie en mémoire des métadonnées peut être interrogée à l'aide des méthodes de l'une des interfaces d'importation ou complétée à l'aide des méthodes de l'une des interfaces d'émission.

La méthode OpenScopeOnMemory est semblable à la méthode IMetaDataDispenser::OpenScope, sauf que les métadonnées concernées existent déjà en mémoire, plutôt que dans un fichier sur le disque.

Si la zone de mémoire cible ne contient pas de métadonnées CLR, la méthode OpenScopeOnMemory échoue.