Méthode IMetaDataDispenser ::OpenScopeOnMemory (rometadataapi.h)

Ouvre une zone de mémoire qui contient des 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 traitées comme des métadonnées.

Syntaxe

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

Paramètres

[in] pData

Pointeur qui spécifie l’adresse de départ de la zone mémoire.

[in] cbData

Taille de la zone de mémoire, en octets.

[in] dwOpenFlags

Valeur de l’énumération CorOpenFlags pour spécifier le mode (lecture, écriture, etc.) pour l’ouverture.

[in] riid

IID de l’interface de métadonnées souhaitée à retourner ; l’appelant utilisera l’interface pour importer (lire) ou émettre (écrire) des métadonnées.

La valeur de riid doit spécifier l’une des interfaces « import » ou « emit ». Les valeurs valides sont IID_IMetaDataEmit, IID_IMetaDataImport, IID_IMetaDataAssemblyEmit, IID_IMetaDataAssemblyImport, IID_IMetaDataEmit2 ou IID_IMetaDataImport2.

[out] ppIUnk

Pointeur vers l’interface retournée.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

La copie en mémoire des métadonnées peut être interrogée à l’aide de méthodes de l’une des interfaces « import » ou ajoutées à l’utilisation de méthodes de l’une des interfaces « emit ».

La méthode OpenScopeOnMemory est similaire à la méthode OpenScope , sauf que les métadonnées intéressantes existent déjà en mémoire, plutôt que dans un fichier sur disque.

Si la zone de mémoire cible ne contient pas de métadonnées CLR (Common Language Runtime), la méthode OpenScopeOnMemory échoue.

Configuration requise

Voir aussi

IMetaDataDispenser