IMetaDataImport

Aggiornamento: novembre 2007

Fornisce metodi per importare e modificare i metadati esistenti da un file eseguibile di tipo PE o da un'altra origine, ad esempio una libreria dei tipi o un binario dei metadati di runtime autonomo.

interface IMetaDataImport : IUnknown {
        
    HRESULT CloseEnum (
        HCORENUM hEnum
    );
        
    HRESULT CountEnum (
        HCORENUM    hEnum, 
        ULONG       *pulCount
    );
        
    HRESULT EnumCustomAttributes ( 
        HCORENUM    *phEnum,
        mdToken     tk, 
        mdToken     tkType, 
        mdCustomAttribute rCustomAttributes[], 
        ULONG       cMax,
        ULONG       *pcCustomAttributes
    );
        
    HRESULT EnumEvents ( 
        HCORENUM    *phEnum, 
        mdTypeDef   td, 
        mdEvent     rEvents[], 
        ULONG       cMax,
        ULONG       *pcEvents
    );
        
    HRESULT EnumFields ( 
        HCORENUM    *phEnum, 
        mdTypeDef   cl, 
        mdFieldDef  rFields[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumFieldsWithName (
        HCORENUM    *phEnum, 
        mdTypeDef   cl, 
        LPCWSTR     szName, 
        mdFieldDef  rFields[], 
        ULONG       cMax, 
        ULONG       *pcTokens 
    );
        
    HRESULT EnumInterfaceImpls (
        HCORENUM        *phEnum, 
        mdTypeDef       td,
        mdInterfaceImpl rImpls[], 
        ULONG           cMax,
        ULONG*          pcImpls
    );
        
    HRESULT EnumMemberRefs (
        HCORENUM    *phEnum, 
        mdToken     tkParent, 
        mdMemberRef rMemberRefs[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumMembers ( 
        HCORENUM    *phEnum, 
        mdTypeDef   cl, 
        mdToken     rMembers[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumMembersWithName (
        HCORENUM    *phEnum, 
        mdTypeDef   cl, 
        LPCWSTR     szName, 
        mdToken     rMembers[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumMethodImpls (
        HCORENUM    *phEnum, 
        mdTypeDef   td, 
        mdToken     rMethodBody[], 
        mdToken     rMethodDecl[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumMethods (
        HCORENUM    *phEnum, 
        mdTypeDef   cl, 
        mdMethodDef rMethods[], 
        ULONG       cMax, 
        ULONG       *pcTokens
    );
        
    HRESULT EnumMethodSemantics (
        HCORENUM    *phEnum,
        mdMethodDef mb, 
        mdToken     rEventProp[], 
        ULONG       cMax,
        ULONG       *pcEventProp
    );
        
    HRESULT EnumMethodsWithName (
        HCORENUM    *phEnum,
        mdTypeDef   cl,
        LPCWSTR     szName,
        mdMethodDef rMethods[],
        ULONG       cMax,
        ULONG       *pcTokens
    );
        
    HRESULT EnumModuleRefs (
        HCORENUM    *phEnum,
        mdModuleRef rModuleRefs[],
        ULONG       cMax,
        ULONG       *pcModuleRefs
    );
        
    HRESULT EnumParams (
        HCORENUM    *phEnum,
        mdMethodDef mb,
        mdParamDef  rParams[],
        ULONG       cMax,
        ULONG       *pcTokens
    );
        
    HRESULT EnumPermissionSets
        HCORENUM    *phEnum, 
        mdToken     tk, 
        DWORD       dwActions,
        mdPermission rPermission[],
        ULONG       cMax,
       ULONG       *pcTokens
    );
        
    HRESULT EnumProperties (
        HCORENUM    *phEnum,
        mdTypeDef   td,
        mdProperty  rProperties[],
        ULONG       cMax,
        ULONG       *pcProperties
    );
        
    HRESULT EnumSignatures (
        HCORENUM    *phEnum,
        mdSignature rSignatures[],
        ULONG       cMax,
        ULONG       *pcSignatures
    );
        
    HRESULT EnumTypeDefs (
        HCORENUM    *phEnum, 
        mdTypeDef   rTypeDefs[],
        ULONG       cMax, 
        ULONG       *pcTypeDefs
    );
        
    HRESULT EnumTypeRefs (
        HCORENUM    *phEnum, 
        mdTypeRef   rTypeRefs[],
        ULONG       cMax, 
        ULONG       *pcTypeRefs
    );
        
    HRESULT EnumTypeSpecs (
        HCORENUM    *phEnum,
        mdTypeSpec  rTypeSpecs[],
        ULONG       cMax,
        ULONG       *pcTypeSpecs
    );
        
    HRESULT EnumUnresolvedMethods (
        HCORENUM    *phEnum,
        mdToken     rMethods[],
        ULONG       cMax,
        ULONG       *pcTokens
        );
        
    HRESULT EnumUserStrings (
        HCORENUM    *phEnum,
        mdString    rStrings[],
                ULONG       cMax,
        ULONG       *pcStrings
    );
        
    HRESULT FindField (
        mdTypeDef   td,
        LPCWSTR     szName,
        PCCOR_SIGNATURE pvSigBlob,
        ULONG       cbSigBlob,
        mdFieldDef  *pmb
    );
        
    HRESULT FindMember (
        mdTypeDef   td,
        LPCWSTR     szName, 
        PCCOR_SIGNATURE pvSigBlob, 
        ULONG       cbSigBlob, 
        mdToken     *pmb
    );
        
    HRESULT FindMemberRef (
        mdTypeRef   td,
        LPCWSTR     szName, 
        PCCOR_SIGNATURE pvSigBlob, 
        ULONG       cbSigBlob, 
        mdMemberRef     *pmr
    );
        
    HRESULT FindMethod (
        mdTypeDef   td,
        LPCWSTR     szName, 
        PCCOR_SIGNATURE pvSigBlob, 
        ULONG       cbSigBlob, 
        mdMethodDef     *pmb
    );
        
    HRESULT FindTypeDefByName
        LPCWSTR     szTypeDef,
        mdToken     tkEnclosingClass,
        mdTypeDef   *ptd
    );
        
    HRESULT FindTypeRef (
        mdToken     tkResolutionScope,
        LPCWSTR     szName,
        mdTypeRef   *ptr
    );
        
    HRESULT GetClassLayout ( 
        mdTypeDef   td, 
        DWORD       *pdwPackSize,
        COR_FIELD_OFFSET rFieldOffset[],
        ULONG       cMax,
        ULONG       *pcFieldOffset,
        ULONG       *pulClassSize
    );
        
    HRESULT GetCustomAttributeByName (
        mdToken     tkObj,
        LPCWSTR     szName,
        const void  **ppData,
        ULONG       *pcbData
    );
        
    HRESULT GetCustomAttributeProps (
        mdCustomAttribute cv,
        mdToken     *ptkObj,
        mdToken     *ptkType,
        void const  **ppBlob,
        ULONG       *pcbSize
    );
        
    HRESULT GetEventProps (
        mdEvent     ev,
        mdTypeDef   *pClass, 
        LPCWSTR     szEvent, 
        ULONG       cchEvent, 
        ULONG       *pchEvent, 
        DWORD       *pdwEventFlags,
        mdToken     *ptkEventType,
        mdMethodDef *pmdAddOn, 
        mdMethodDef *pmdRemoveOn, 
        mdMethodDef *pmdFire, 
        mdMethodDef rmdOtherMethod[], 
        ULONG       cMax,
        ULONG       *pcOtherMethod
    );
        
    HRESULT GetFieldMarshal (
        mdToken     tk, 
        PCCOR_SIGNATURE *ppvNativeType,
        ULONG       *pcbNativeType 
    );
        
    HRESULT GetFieldProps (
        mdFieldDef  mb, 
        mdTypeDef   *pClass,
        LPWSTR      szField,
        ULONG       cchField, 
        ULONG       *pchField,
        DWORD       *pdwAttr,
        PCCOR_SIGNATURE *ppvSigBlob, 
        ULONG       *pcbSigBlob, 
        DWORD       *pdwCPlusTypeFlag, 
        UVCP_CONSTANT *ppValue,
        ULONG       *pcchValue
    );
        
    HRESULT GetInterfaceImplProps (
        mdInterfaceImpl iiImpl,
        mdTypeDef   *pClass,
        mdToken     *ptkIface)
    );
        
    HRESULT GetMemberProps (
        mdToken     mb, 
        mdTypeDef   *pClass,
        LPWSTR      szMember, 
        ULONG       cchMember, 
        ULONG       *pchMember, 
        DWORD       *pdwAttr,
        PCCOR_SIGNATURE *ppvSigBlob, 
        ULONG       *pcbSigBlob, 
        ULONG       *pulCodeRVA, 
        DWORD       *pdwImplFlags, 
        DWORD       *pdwCPlusTypeFlag, 
        UVCP_CONSTANT *ppValue,
        ULONG       *pcchValue
    );

    HRESULT GetMemberRefProps (
        mdMemberRef mr, 
        mdToken     *ptk, 
        LPWSTR      szMember, 
        ULONG       cchMember, 
        ULONG       *pchMember, 
        PCCOR_SIGNATURE *ppvSigBlob, 
        ULONG       *pbSig 
    );

    HRESULT GetMethodProps (
        mdMethodDef mb, 
        mdTypeDef   *pClass, 
        LPWSTR      szMethod, 
        ULONG       cchMethod, 
        ULONG       *pchMethod,
        DWORD       *pdwAttr, 
        PCCOR_SIGNATURE *ppvSigBlob, 
        ULONG       *pcbSigBlob, 
        ULONG       *pulCodeRVA, 
        DWORD       *pdwImplFlags
    );
        
    HRESULT GetMethodSemantics (
        mdMethodDef mb,
        mdToken     tkEventProp,
        DWORD       *pdwSemanticsFlags
    );
                
    HRESULT GetModuleFromScope (
        mdModule    *pmd
    );
        
    HRESULT GetModuleRefProps (
        mdModuleRef mur,
        LPWSTR      szName, 
        ULONG       cchName, 
        ULONG       *pchName 
    );
        
    HRESULT GetNameFromToken (
        mdToken     tk,
        MDUTF8CSTR  *pszUtf8NamePtr
    );
        
    HRESULT GetNativeCallConvFromSig (
        void const  *pvSig,
        ULONG       cbSig,
        ULONG       *pCallConv
    );
        
    HRESULT GetNestedClassProps (
        mdTypeDef   tdNestedClass,
        mdTypeDef   *ptdEnclosingClass
    );
        
    HRESULT GetParamForMethodIndex (
        mdMethodDef md,
        ULONG       ulParamSeq,
        mdParamDef  *ppd
    );

    HRESULT GetParamProps (
        mdParamDef  tk,
        mdMethodDef *pmd,
        ULONG       *pulSequence,
        LPWSTR      szName,
        ULONG       cchName,
        ULONG       *pchName,
        DWORD       *pdwAttr,
        DWORD       *pdwCPlusTypeFlag,
        UVCP_CONSTANT *ppValue,
        ULONG       *pcchValue
    );
        
    HRESULT GetPermissionSetProps (
        mdPermission pm,
        DWORD       *pdwAction, 
        void const  **ppvPermission, 
        ULONG       *pcbPermission
    );
        
    HRESULT GetPinvokeMap (
        mdToken     tk,
        DWORD       *pdwMappingFlags,
        LPWSTR      szImportName,
        ULONG       cchImportName,
        ULONG       *pchImportName,
        mdModuleRef *pmrImportDLL
    );
        
    HRESULT GetPropertyProps (
        mdProperty  prop,
        mdTypeDef   *pClass, 
        LPCWSTR     szProperty, 
        ULONG       cchProperty, 
        ULONG       *pchProperty, 
        DWORD       *pdwPropFlags, 
        PCCOR_SIGNATURE *ppvSig, 
        ULONG       *pbSig, 
        DWORD       *pdwCPlusTypeFlag, 
        UVCP_CONSTANT *ppDefaultValue,
        ULONG       *pcchDefaultValue,
        mdMethodDef *pmdSetter, 
        mdMethodDef *pmdGetter, 
        mdMethodDef rmdOtherMethod[],
        ULONG       cMax, 
        ULONG       *pcOtherMethod 
    );
        
    HRESULT GetRVA (
        mdToken     tk, 
        ULONG       *pulCodeRVA, 
        DWORD       *pdwImplFlags
    );
        
    HRESULT GetScopeProps (
        LPWSTR      szName,
        ULONG       cchName,
        ULONG       *pchName,
        GUID        *pmvid
    );
        
    HRESULT GetSigFromToken ( 
        mdSignature mdSig, 
        PCCOR_SIGNATURE *ppvSig, 
        ULONG       *pcbSig 
    );
        
    HRESULT GetTypeDefProps 
        mdTypeDef   td,
        LPWSTR      szTypeDef,
        ULONG       cchTypeDef,
        ULONG       *pchTypeDef,
        DWORD       *pdwTypeDefFlags,
        mdToken     *ptkExtends
    );
        
    HRESULT GetTypeRefProps (
        mdTypeRef   tr,
        mdToken     *ptkResolutionScope,
        LPWSTR      szName,
        ULONG       cchName,
        ULONG       *pchName
    );
        
    HRESULT GetTypeSpecFromToken ( 
        mdTypeSpec  typespec, 
        PCCOR_SIGNATURE *ppvSig, 
        ULONG       *pcbSig
    );
        
    HRESULT GetUserString (
        mdString    stk,
        LPWSTR      szString,
        ULONG       cchString,
        ULONG       *pchString
    );
        
    HRESULT IsGlobal (
        mdToken     pd,
        int         *pbGlobal
    );
        
    BOOL IsValidToken (
        mdToken     tk
    );

    HRESULT ResetEnum (
        HCORENUM    hEnum, 
        ULONG       ulPos
    );
        
    HRESULT ResolveTypeRef (
        mdTypeRef   tr,
        REFIID      riid,
        IUnknown    **ppIScope,
        mdTypeDef   *ptd
    );
        
};

Metodi

Metodo	Descrizione
Metodo IMetaDataImport::CloseEnum	Chiude l'enumeratore con l'handle specificato.
Metodo IMetaDataImport::CountEnum	Ottiene il numero di elementi nell'enumeratore con l'handle specificato.
Metodo IMetaDataImport::EnumCustomAttributes	Enumera un elenco di token di definizione di attributo personalizzato associati al tipo o al membro specificato.
Metodo IMetaDataImport::EnumEvents	Enumera i token di definizione di evento per il token TypeDef specificato.
Metodo IMetaDataImport::EnumFields	Enumera i token FieldDef per il tipo a cui fa riferimento il token TypeDef specificato.
Metodo IMetaDataImport::EnumFieldsWithName	Enumera i token FieldDef del tipo specificato con il nome specificato.
Metodo IMetaDataImport::EnumInterfaceImpls	Enumera i token MethodDef che rappresentano le implementazioni dell'interfaccia.
Metodo IMetaDataImport::EnumMemberRefs	Enumera i token MemberRef che rappresentano i membri del tipo specificato.
Metodo IMetaDataImport::EnumMembers	Enumera i token MemberDef che rappresentano i membri del tipo specificato.
Metodo IMetaDataImport::EnumMembersWithName	Enumera i token MemberDef che rappresentano i membri del tipo specificato con il nome specificato.
Metodo IMetaDataImport::EnumMethodImpls	Enumera i token MethodBody e MethodDeclaration che rappresentano i metodi del tipo specificato.
Metodo IMetaDataImport::EnumMethods	Enumera i token MethodDef che rappresentano i metodi del tipo specificato.
Metodo IMetaDataImport::EnumMethodSemantics	Enumera le proprietà e gli eventi di modifica delle proprietà a cui è correlato il metodo specificato.
Metodo IMetaDataImport::EnumMethodsWithName	Enumera i metodi che hanno il nome specificato e che sono definiti dal tipo a cui fa riferimento il token TypeDef specificato.
Metodo IMetaDataImport::EnumModuleRefs	Enumera i token ModuleRef che rappresentano i moduli importati.
Metodo IMetaDataImport::EnumParams	Enumera i token ParamDef che rappresentano i parametri del metodo a cui fa riferimento il token MethodDef specificato.
Metodo IMetaDataImport::EnumPermissionSets	Enumera le autorizzazioni per gli oggetti in un ambito dei metadati specificato.
Metodo IMetaDataImport::EnumProperties	Enumera i token PropertyDef che rappresentano le proprietà del tipo a cui fa riferimento il token TypeDef specificato.
Metodo IMetaDataImport::EnumSignatures	Enumera i token Signature che rappresentano le firme autonome nell'ambito corrente.
Metodo IMetaDataImport::EnumTypeDefs	Enumera i token TypeDef che rappresentano tutti i tipi all'interno dell'ambito corrente.
Metodo IMetaDataImport::EnumTypeRefs	Enumera i token TypeRef definiti nell'ambito dei metadati corrente.
Metodo IMetaDataImport::EnumTypeSpecs	Enumera i token TypeSpec definiti nell'ambito dei metadati corrente.
Metodo IMetaDataImport::EnumUnresolvedMethods	Enumera i token MemberDef che rappresentano i metodi non risolti nell'ambito dei metadati corrente.
Metodo IMetaDataImport::EnumUserStrings	Enumera i token String che rappresentano le stringhe specificate a livello di codice (hard-coded) nell'ambito dei metadati corrente.
Metodo IMetaDataImport::FindField	Ottiene un token FieldDef per il campo membro del tipo specificato a cui corrispondono il nome e la firma dei metadati specificati.
Metodo IMetaDataImport::FindMember	Ottiene un puntatore al token MemberDef per il membro definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo IMetaDataImport::FindMemberRef	Ottiene un puntatore al token MemberRef per il membro definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo IMetaDataImport::FindMethod	Ottiene un puntatore al token MethodDef per il metodo definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo IMetaDataImport::FindTypeDefByName	Ottiene un puntatore al token TypeDef per il tipo con il nome specificato.
Metodo IMetaDataImport::FindTypeRef	Ottiene un puntatore al token di metadati TypeRef che fa riferimento al tipo con il nome specificato nell'ambito di ricerca indicato.
Metodo IMetaDataImport::GetClassLayout	Ottiene le informazioni sul layout per la classe a cui fa riferimento il token TypeDef specificato.
Metodo IMetaDataImport::GetCustomAttributeByName	Ottiene il valore dell'attributo personalizzato, dato il relativo nome.
Metodo IMetaDataImport::GetCustomAttributeProps	Ottiene il valore dell'attributo personalizzato, dato il relativo token di metadati.
Metodo IMetaDataImport::GetEventProps	Ottiene informazioni sui metadati, tra cui il tipo dichiarante, i metodi di aggiunta ed eliminazione per i delegati, i flag e gli altri dati associati, per l'evento rappresentato dal token specificato.
Metodo IMetaDataImport::GetFieldMarshal	Ottiene un puntatore al tipo nativo non gestito del campo rappresentato dal token di metadati specificato.
Metodo IMetaDataImport::GetFieldProps	Ottiene i metadati associati al campo a cui fa riferimento il token FieldDef specificato.
Metodo IMetaDataImport::GetInterfaceImplProps	Ottiene un puntatore ai token di metadati per il tipo che implementa il metodo specificato e per l'interfaccia che dichiara tale metodo.
Metodo IMetaDataImport::GetMemberProps	Ottiene le informazioni sui metadati, inclusi il nome, la firma binaria e l'indirizzo virtuale relativo, del membro del tipo a cui fa riferimento il token di metadati specificato.
Metodo IMetaDataImport::GetMemberRefProps	Ottiene i metadati associati al membro a cui fa riferimento il token specificato.
Metodo IMetaDataImport::GetMethodProps	Ottiene i metadati associati al metodo a cui fa riferimento il token MethodDef specificato.
Metodo IMetaDataImport::GetMethodSemantics	Ottiene un puntatore alla relazione tra il metodo a cui fa riferimento il token MethodDef specificato e l'associazione di proprietà ed evento a cui fa riferimento il token EventProp specificato.
Metodo IMetaDataImport::GetModuleFromScope	Ottiene un puntatore al token di metadati per il modulo a cui si fa riferimento nell'ambito dei metadati corrente.
Metodo IMetaDataImport::GetModuleRefProps	Ottiene il nome del modulo a cui fa riferimento il token di metadati specificato.
Metodo IMetaDataImport::GetNameFromToken	Ottiene il nome in formato UTF-8 dell'oggetto a cui fa riferimento il token di metadati specificato.
Metodo IMetaDataImport::GetNativeCallConvFromSig	Ottiene la convenzione di chiamata nativa per il metodo rappresentato dal puntatore a firma specificato.
Metodo IMetaDataImport::GetNestedClassProps	Ottiene il token TypeDef per il tipo dell'elemento padre che contiene il tipo nidificato specificato.
Metodo IMetaDataImport::GetParamForMethodIndex	Ottiene un puntatore al token che rappresenta il parametro nella posizione ordinale specificata nella sequenza di parametri di metodo relativi al metodo rappresentato dal token MethodDef specificato.
Metodo IMetaDataImport::GetParamProps	Ottiene i valori di metadati relativi al parametro a cui fa riferimento il token ParamDef specificato.
Metodo IMetaDataImport::GetPermissionSetProps	Ottiene i metadati associati all'oggetto System.Security.PermissionSet rappresentato dal token Permission specificato.
Metodo IMetaDataImport::GetPinvokeMap	Ottiene un token ModuleRef per rappresentare l'assembly di destinazione di una chiamata PInvoke.
Metodo IMetaDataImport::GetPropertyProps	Ottiene i metadati associati alla proprietà rappresentata dal token specificato.
Metodo IMetaDataImport::GetRVA	Ottiene l'offset dell'indirizzo virtuale relativo dell'oggetto codice rappresentato dal token specificato.
Metodo IMetaDataImport::GetScopeProps	Ottiene il nome ed eventualmente l'identificatore di versione dell'assembly o del modulo nell'ambito dei metadati corrente.
Metodo IMetaDataImport::GetSigFromToken	Ottiene la firma binaria dei metadati associata al token specificato.
Metodo IMetaDataImport::GetTypeDefProps	Restituisce le informazioni sui metadati per il tipo rappresentato dal token TypeDef specificato.
Metodo IMetaDataImport::GetTypeRefProps	Ottiene i metadati associati al tipo a cui fa riferimento il token TypeRef specificato.
Metodo IMetaDataImport::GetTypeSpecFromToken	Ottiene la firma binaria dei metadati della specifica del tipo rappresentata dal token indicato.
Metodo IMetaDataImport::GetUserString	Ottiene la stringa letterale rappresentata dal token di metadati specificato.
Metodo IMetaDataImport::IsGlobal	Ottiene un valore che indica se il campo, il metodo o il tipo rappresentato dal token di metadati specificato ha ambito globale.
Metodo IMetaDataImport::IsValidToken	Ottiene un valore che indica se il token specificato contiene un riferimento valido a un oggetto codice.
Metodo IMetaDataImport::ResetEnum	Reimposta l'enumeratore specificato nella posizione specificata.
Metodo IMetaDataImport::ResolveTypeRef	Ottiene le informazioni per il tipo a cui fa riferimento il token TypeRef specificato.

Note

L'interfaccia IMetaDataImport è progettata principalmente per essere utilizzata da strumenti e servizi che importeranno informazioni sul tipo, ad esempio strumenti di sviluppo, o gestiranno componenti distribuiti, quali servizi di risoluzione o attivazione. I metodi di IMetaDataImport rientrano nelle seguenti categorie di attività:

Enumerazione di insiemi di elementi nell'ambito dei metadati.
Ricerca di un elemento con una serie specifica di caratteristiche.
Recupero delle proprietà di un elemento specificato.
I metodi Get sono progettati specificamente per restituire le proprietà a valore singolo di un elemento dei metadati. Quando la proprietà è un riferimento a un altro elemento, viene restituito un token per tale elemento. Qualunque tipo di input del puntatore può essere NULL per indicare che il valore in questione non è richiesto. Per ottenere proprietà che siano essenzialmente oggetti insieme, ad esempio l'insieme di interfacce implementate da una classe, utilizzare i metodi di enumerazione.