diff options
Diffstat (limited to 'src/md/compiler/regmeta.h')
-rw-r--r-- | src/md/compiler/regmeta.h | 2123 |
1 files changed, 2123 insertions, 0 deletions
diff --git a/src/md/compiler/regmeta.h b/src/md/compiler/regmeta.h new file mode 100644 index 0000000000..cb7bae17b5 --- /dev/null +++ b/src/md/compiler/regmeta.h @@ -0,0 +1,2123 @@ +// Licensed to the .NET Foundation under one or more agreements. +// The .NET Foundation licenses this file to you under the MIT license. +// See the LICENSE file in the project root for more information. +//***************************************************************************** +// RegMeta.h +// + +// +// This is the code for the MetaData coclass including both the emit and +// import API's. +// +// This provides an implementation of the public Metadata interfaces via the RegMeta class. It's +// primarily intended for use by tools such as compilers, debuggers, and profilers. +//***************************************************************************** +#ifndef __RegMeta__h__ +#define __RegMeta__h__ + +#include <metamodelrw.h> +#include <corperm.h> +#include "../inc/mdlog.h" +#include "utsem.h" + +#include "newmerger.h" + +#include "rwutil.h" +#include "mdperf.h" +#include <ivehandler.h> + +#include "sigparser.h" +#ifdef FEATURE_FUSION +#include "fusion.h" +#endif + +#include "winmdinterfaces.h" + +class FilterManager; + +// Support for symbol binding meta data. This is a custom value hung off of +// the Module entry. The CORDBG_SYMBOL_URL needs to be allocated on top of +// a buffer large enough to hold it. +// +#define SZ_CORDBG_SYMBOL_URL W("DebugSymbolUrlData") + +struct CORDBG_SYMBOL_URL +{ + GUID FormatID; // ID of the format type. + WCHAR rcName[2]; // Variable sized name of the item. + +#ifdef _PREFAST_ +#pragma warning(push) +#pragma warning(disable:6305) // "Potential mismatch between sizeof and countof quantities" +#endif + + ULONG Size() const + { + return (ULONG)(sizeof(GUID) + ((wcslen(rcName) + 1) * 2)); + } + +#ifdef _PREFAST_ +#pragma warning(pop) +#endif +}; + + +// +// Internal open flags. +// +#define ofExternalStgDB ofReserved1 +#define IsOfExternalStgDB(x) ((x) & ofExternalStgDB) +#define ofReOpen ofReserved2 +#define IsOfReOpen(x) ((x) & ofReOpen) + + +// Set API caller type +enum SetAPICallerType +{ + DEFINE_API = 0x1, + EXTERNAL_CALLER = 0x2 +}; + +// Define the record entry for the table over which ValidateMetaData iterates over. +// Add a forward declaration for RegMeta. +class RegMeta; +typedef HRESULT (RegMeta::*ValidateRecordFunction)(RID); + +// Support for security attributes. Bundles of attributes (they look much like +// custom attributes) are passed into a single API (DefineSecurityAttributeSet) +// where they're processed and written into the metadata as one or more opaque +// blobs of data. +struct CORSEC_ATTR +{ + CORSEC_ATTR *pNext; // Next structure in list or NULL. + mdToken tkObj; // The object to put the value on. + mdMemberRef tkCtor; // The security attribute constructor. + mdTypeRef tkTypeRef; // Ref to the security attribute type. + mdAssemblyRef tkAssemblyRef; // Ref to the assembly containing the security attribute class. + void const *pCustomAttribute; // The custom value data. + ULONG cbCustomAttribute; // The custom value data length. +}; + +// Support for "Pseudo Custom Attributes". +struct CCustAttrHashKey +{ + mdToken tkType; // Token of the custom attribute type. + int ca; // flag indicating what the ca is. +}; + +class CCustAttrHash : public CClosedHashEx<CCustAttrHashKey, CCustAttrHash> +{ + typedef CCustAttrHashKey T; + + using CClosedHashEx<CCustAttrHashKey, CCustAttrHash>::Hash; + using CClosedHashEx<CCustAttrHashKey, CCustAttrHash>::Compare; + using CClosedHashEx<CCustAttrHashKey, CCustAttrHash>::Status; + using CClosedHashEx<CCustAttrHashKey, CCustAttrHash>::SetStatus; + using CClosedHashEx<CCustAttrHashKey, CCustAttrHash>::GetKey; + +public: + CCustAttrHash(int iBuckets=37) : CClosedHashEx<CCustAttrHashKey,CCustAttrHash>(iBuckets) {} + unsigned int Hash(const T *pData); + unsigned int Compare(const T *p1, T *p2); + ELEMENTSTATUS Status(T *pEntry); + void SetStatus(T *pEntry, ELEMENTSTATUS s); + void* GetKey(T *pEntry); +}; + +class MDInternalRW; +struct CaArg; +struct CaNamedArg; + +#ifdef FEATURE_METADATA_RELEASE_MEMORY_ON_REOPEN +#define REGMETA_POSSIBLE_INTERNAL_POINTER_EXPOSED() MarkUnsafeToDeleteStgdb() +#else +#define REGMETA_POSSIBLE_INTERNAL_POINTER_EXPOSED() +#endif + +// The RegMeta class implements the public metadata interfaces. +// +// Notes: +// This object is primarily consumed by tools, not the runtime itself. (The runtime should be +// using the internal metadata interfaces, not the public ones implemented here). +// The VM uses it for IMetaDataEmit* interfaces. Define* methods are not exposed to the VM +// (eg for Reflection) otherwise. +// This object is a thin veneer exposing a public interface on top of the real storage. +// The runtime also has internal interfaces to access that storage. +// +// This is included outside of md\compiler; so be very careful about using #ifdef to change class layout +// (adding removing interfaces changes class layout) +// +// This exists in both the full and standalone versions of the metadata. +// + +class RegMeta : + public IMetaDataImport2, + public IMetaDataAssemblyImport, + public IMetaDataTables2 + +#ifndef FEATURE_METADATA_STANDALONE_WINRT + , public IMetaDataInfo +#endif + +#ifdef FEATURE_METADATA_EMIT + , public IMetaDataEmit2 + , public IMetaDataAssemblyEmit +#endif + +#ifdef FEATURE_METADATA_VALIDATOR + , public IMetaDataValidate +#endif + +#ifdef FEATURE_METADATA_EMIT_ALL + , public IMetaDataFilter +#endif + +#ifdef FEATURE_METADATA_INTERNAL_APIS + , public IMetaDataHelper + , public IMDInternalEmit + , public IGetIMDInternalImport +#endif + +#if defined(FEATURE_METADATA_EMIT) && defined(FEATURE_METADATA_INTERNAL_APIS) + , public IMetaDataEmitHelper +#endif + +#if defined(FEATURE_METADATA_IN_VM) && defined(FEATURE_PREJIT) + , public IMetaDataCorProfileData + , public IMDInternalMetadataReorderingOptions +#endif + , public IMDCommon +{ + friend class NEWMERGER; + friend class CImportTlb; + friend class MDInternalRW; + friend class MDInternalRO; + friend HRESULT TranslateSigHelper( + IMDInternalImport* pImport, + IMDInternalImport* pAssemImport, + const void* pbHashValue, + ULONG cbHashValue, + PCCOR_SIGNATURE pbSigBlob, + ULONG cbSigBlob, + IMetaDataAssemblyEmit* pAssemEmit, + IMetaDataEmit* emit, + CQuickBytes* pqkSigEmit, + ULONG* pcbSig); +public: +//***************************************************************************** +// IUnknown methods +//***************************************************************************** + STDMETHODIMP QueryInterface(REFIID riid, void** ppv); + STDMETHODIMP_(ULONG) AddRef(void); + STDMETHODIMP_(ULONG) Release(void); + +//***************************************************************************** +// IMetaDataImport methods +//***************************************************************************** + void STDMETHODCALLTYPE CloseEnum(HCORENUM hEnum); + STDMETHODIMP CountEnum(HCORENUM hEnum, ULONG *pulCount); + STDMETHODIMP ResetEnum(HCORENUM hEnum, ULONG ulPos); + STDMETHODIMP EnumTypeDefs(HCORENUM *phEnum, mdTypeDef rTypeDefs[], + ULONG cMax, ULONG *pcTypeDefs); + STDMETHODIMP EnumInterfaceImpls(HCORENUM *phEnum, mdTypeDef td, + mdInterfaceImpl rImpls[], ULONG cMax, + ULONG* pcImpls); + STDMETHODIMP EnumTypeRefs(HCORENUM *phEnum, mdTypeRef rTypeRefs[], + ULONG cMax, ULONG* pcTypeRefs); + STDMETHODIMP FindTypeDefByName( // S_OK or error. + LPCWSTR szTypeDef, // [IN] Name of the Type. + mdToken tdEncloser, // [IN] TypeDef/TypeRef of Enclosing class. + mdTypeDef *ptd); // [OUT] Put the TypeDef token here. + + STDMETHODIMP GetScopeProps( // S_OK or error. + __out_ecount_opt (cchName) LPWSTR szName, // [OUT] Put name here. + ULONG cchName, // [IN] Size of name buffer in wide chars. + ULONG *pchName, // [OUT] Put size of name (wide chars) here. + GUID *pmvid); // [OUT] Put MVID here. + + STDMETHODIMP GetModuleFromScope( // S_OK. + mdModule *pmd); // [OUT] Put mdModule token here. + + STDMETHODIMP GetTypeDefProps( // S_OK or error. + mdTypeDef td, // [IN] TypeDef token for inquiry. + __out_ecount_opt (cchTypeDef) LPWSTR szTypeDef, // [OUT] Put name here. + ULONG cchTypeDef, // [IN] size of name buffer in wide chars. + ULONG *pchTypeDef, // [OUT] put size of name (wide chars) here. + DWORD *pdwTypeDefFlags, // [OUT] Put flags here. + mdToken *ptkExtends); // [OUT] Put base class TypeDef/TypeRef here. + + STDMETHODIMP GetInterfaceImplProps( // S_OK or error. + mdInterfaceImpl iiImpl, // [IN] InterfaceImpl token. + mdTypeDef *pClass, // [OUT] Put implementing class token here. + mdToken *ptkIface); // [OUT] Put implemented interface token here. + + STDMETHODIMP GetTypeRefProps( + mdTypeRef tr, // S_OK or error. + mdToken *ptkResolutionScope, // [OUT] Resolution scope, mdModuleRef or mdAssemblyRef. + __out_ecount_opt (cchName) LPWSTR szName, // [OUT] Name buffer. + ULONG cchName, // [IN] Size of Name buffer. + ULONG *pchName); // [OUT] Actual size of Name. + + // This access global shared state to looks across multiple metadata scopes that would + // otherwise be independent. + STDMETHODIMP ResolveTypeRef(mdTypeRef tr, REFIID riid, IUnknown **ppIScope, mdTypeDef *ptd); + + STDMETHODIMP EnumMembers( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + mdToken rMembers[], // [OUT] Put MemberDefs here. + ULONG cMax, // [IN] Max MemberDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumMembersWithName( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + LPCWSTR szName, // [IN] Limit results to those with this name. + mdToken rMembers[], // [OUT] Put MemberDefs here. + ULONG cMax, // [IN] Max MemberDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumMethods( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + mdMethodDef rMethods[], // [OUT] Put MethodDefs here. + ULONG cMax, // [IN] Max MethodDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumMethodsWithName( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + LPCWSTR szName, // [IN] Limit results to those with this name. + mdMethodDef rMethods[], // [OU] Put MethodDefs here. + ULONG cMax, // [IN] Max MethodDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumFields( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + mdFieldDef rFields[], // [OUT] Put FieldDefs here. + ULONG cMax, // [IN] Max FieldDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumFieldsWithName( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef cl, // [IN] TypeDef to scope the enumeration. + LPCWSTR szName, // [IN] Limit results to those with this name. + mdFieldDef rFields[], // [OUT] Put MemberDefs here. + ULONG cMax, // [IN] Max MemberDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + + STDMETHODIMP EnumParams( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdMethodDef mb, // [IN] MethodDef to scope the enumeration. + mdParamDef rParams[], // [OUT] Put ParamDefs here. + ULONG cMax, // [IN] Max ParamDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumMemberRefs( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdToken tkParent, // [IN] Parent token to scope the enumeration. + mdMemberRef rMemberRefs[], // [OUT] Put MemberRefs here. + ULONG cMax, // [IN] Max MemberRefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumMethodImpls( // S_OK, S_FALSE, or error + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef td, // [IN] TypeDef to scope the enumeration. + mdToken rMethodBody[], // [OUT] Put Method Body tokens here. + mdToken rMethodDecl[], // [OUT] Put Method Declaration tokens here. + ULONG cMax, // [IN] Max tokens to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumPermissionSets( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdToken tk, // [IN] if !NIL, token to scope the enumeration. + DWORD dwActions, // [IN] if !0, return only these actions. + mdPermission rPermission[], // [OUT] Put Permissions here. + ULONG cMax, // [IN] Max Permissions to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP FindMember( + mdTypeDef td, // [IN] given typedef + LPCWSTR szName, // [IN] member name + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdToken *pmb); // [OUT] matching memberdef + + STDMETHODIMP FindMethod( + mdTypeDef td, // [IN] given typedef + LPCWSTR szName, // [IN] member name + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdMethodDef *pmb); // [OUT] matching memberdef + + STDMETHODIMP FindField( + mdTypeDef td, // [IN] given typedef + LPCWSTR szName, // [IN] member name + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdFieldDef *pmb); // [OUT] matching memberdef + + STDMETHODIMP FindMemberRef( + mdTypeRef td, // [IN] given typeRef + LPCWSTR szName, // [IN] member name + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdMemberRef *pmr); // [OUT] matching memberref + + STDMETHODIMP GetMethodProps( + mdMethodDef mb, // The method for which to get props. + mdTypeDef *pClass, // Put method's class here. + __out_ecount_opt (cchMethod) LPWSTR szMethod, // Put method's name here. + ULONG cchMethod, // Size of szMethod buffer in wide chars. + ULONG *pchMethod, // Put actual size here + DWORD *pdwAttr, // Put flags here. + PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to the blob value of meta data + ULONG *pcbSigBlob, // [OUT] actual size of signature blob + ULONG *pulCodeRVA, // [OUT] codeRVA + DWORD *pdwImplFlags); // [OUT] Impl. Flags + + STDMETHODIMP GetMemberRefProps( // S_OK or error. + mdMemberRef mr, // [IN] given memberref + mdToken *ptk, // [OUT] Put classref or classdef here. + __out_ecount_opt (cchMember) LPWSTR szMember, // [OUT] buffer to fill for member's name + ULONG cchMember, // [IN] the count of char of szMember + ULONG *pchMember, // [OUT] actual count of char in member name + PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to meta data blob value + ULONG *pbSig); // [OUT] actual size of signature blob + + STDMETHODIMP EnumProperties( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef td, // [IN] TypeDef to scope the enumeration. + mdProperty rProperties[], // [OUT] Put Properties here. + ULONG cMax, // [IN] Max properties to put. + ULONG *pcProperties); // [OUT] Put # put here. + + STDMETHODIMP EnumEvents( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdTypeDef td, // [IN] TypeDef to scope the enumeration. + mdEvent rEvents[], // [OUT] Put events here. + ULONG cMax, // [IN] Max events to put. + ULONG *pcEvents); // [OUT] Put # put here. + + STDMETHODIMP GetEventProps( // S_OK, S_FALSE, or error. + mdEvent ev, // [IN] event token + mdTypeDef *pClass, // [OUT] typedef containing the event declarion. + LPCWSTR szEvent, // [OUT] Event name + ULONG cchEvent, // [IN] the count of wchar of szEvent + ULONG *pchEvent, // [OUT] actual count of wchar for event's name + DWORD *pdwEventFlags, // [OUT] Event flags. + mdToken *ptkEventType, // [OUT] EventType class + mdMethodDef *pmdAddOn, // [OUT] AddOn method of the event + mdMethodDef *pmdRemoveOn, // [OUT] RemoveOn method of the event + mdMethodDef *pmdFire, // [OUT] Fire method of the event + mdMethodDef rmdOtherMethod[], // [OUT] other method of the event + ULONG cMax, // [IN] size of rmdOtherMethod + ULONG *pcOtherMethod); // [OUT] total number of other method of this event + + STDMETHODIMP EnumMethodSemantics( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdMethodDef mb, // [IN] MethodDef to scope the enumeration. + mdToken rEventProp[], // [OUT] Put Event/Property here. + ULONG cMax, // [IN] Max properties to put. + ULONG *pcEventProp); // [OUT] Put # put here. + + STDMETHODIMP GetMethodSemantics( // S_OK, S_FALSE, or error. + mdMethodDef mb, // [IN] method token + mdToken tkEventProp, // [IN] event/property token. + DWORD *pdwSemanticsFlags); // [OUT] the role flags for the method/propevent pair + + STDMETHODIMP GetClassLayout( + mdTypeDef td, // [IN] give typedef + DWORD *pdwPackSize, // [OUT] 1, 2, 4, 8, or 16 + COR_FIELD_OFFSET rFieldOffset[], // [OUT] field offset array + ULONG cMax, // [IN] size of the array + ULONG *pcFieldOffset, // [OUT] needed array size + ULONG *pulClassSize); // [OUT] the size of the class + + STDMETHODIMP GetFieldMarshal( + mdToken tk, // [IN] given a field's memberdef + PCCOR_SIGNATURE *ppvNativeType, // [OUT] native type of this field + ULONG *pcbNativeType); // [OUT] the count of bytes of *ppvNativeType + + STDMETHODIMP GetRVA( // S_OK or error. + mdToken tk, // Member for which to set offset + ULONG *pulCodeRVA, // The offset + DWORD *pdwImplFlags); // the implementation flags + + STDMETHODIMP GetPermissionSetProps( + mdPermission pm, // [IN] the permission token. + DWORD *pdwAction, // [OUT] CorDeclSecurity. + void const **ppvPermission, // [OUT] permission blob. + ULONG *pcbPermission); // [OUT] count of bytes of pvPermission. + + STDMETHODIMP GetSigFromToken( // S_OK or error. + mdSignature mdSig, // [IN] Signature token. + PCCOR_SIGNATURE *ppvSig, // [OUT] return pointer to token. + ULONG *pcbSig); // [OUT] return size of signature. + + STDMETHODIMP GetModuleRefProps( // S_OK or error. + mdModuleRef mur, // [IN] moduleref token. + __out_ecount_opt (cchName) LPWSTR szName, // [OUT] buffer to fill with the moduleref name. + ULONG cchName, // [IN] size of szName in wide characters. + ULONG *pchName); // [OUT] actual count of characters in the name. + + STDMETHODIMP EnumModuleRefs( // S_OK or error. + HCORENUM *phEnum, // [IN|OUT] pointer to the enum. + mdModuleRef rModuleRefs[], // [OUT] put modulerefs here. + ULONG cmax, // [IN] max memberrefs to put. + ULONG *pcModuleRefs); // [OUT] put # put here. + + STDMETHODIMP GetTypeSpecFromToken( // S_OK or error. + mdTypeSpec typespec, // [IN] TypeSpec token. + PCCOR_SIGNATURE *ppvSig, // [OUT] return pointer to TypeSpec signature + ULONG *pcbSig); // [OUT] return size of signature. + + STDMETHODIMP GetNameFromToken( // S_OK or error. + mdToken tk, // [IN] Token to get name from. Must have a name. + MDUTF8CSTR *pszUtf8NamePtr); // [OUT] Return pointer to UTF8 name in heap. + + STDMETHODIMP EnumUnresolvedMethods( // S_OK, S_FALSE, or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdToken rMethods[], // [OUT] Put MemberDefs here. + ULONG cMax, // [IN] Max MemberDefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP GetUserString( // S_OK or error. + mdString stk, // [IN] String token. + __out_ecount_opt (cchString) LPWSTR szString, // [OUT] Copy of string. + ULONG cchString, // [IN] Max chars of room in szString. + ULONG *pchString); // [OUT] How many chars in actual string. + + STDMETHODIMP GetPinvokeMap( // S_OK or error. + mdToken tk, // [IN] FieldDef or MethodDef. + DWORD *pdwMappingFlags, // [OUT] Flags used for mapping. + __out_ecount_opt (cchImportName) LPWSTR szImportName, // [OUT] Import name. + ULONG cchImportName, // [IN] Size of the name buffer. + ULONG *pchImportName, // [OUT] Actual number of characters stored. + mdModuleRef *pmrImportDLL); // [OUT] ModuleRef token for the target DLL. + + STDMETHODIMP EnumSignatures( // S_OK or error. + HCORENUM *phEnum, // [IN|OUT] pointer to the enum. + mdSignature rSignatures[], // [OUT] put signatures here. + ULONG cmax, // [IN] max signatures to put. + ULONG *pcSignatures); // [OUT] put # put here. + + STDMETHODIMP EnumTypeSpecs( // S_OK or error. + HCORENUM *phEnum, // [IN|OUT] pointer to the enum. + mdTypeSpec rTypeSpecs[], // [OUT] put TypeSpecs here. + ULONG cmax, // [IN] max TypeSpecs to put. + ULONG *pcTypeSpecs); // [OUT] put # put here. + + STDMETHODIMP EnumUserStrings( // S_OK or error. + HCORENUM *phEnum, // [IN/OUT] pointer to the enum. + mdString rStrings[], // [OUT] put Strings here. + ULONG cmax, // [IN] max Strings to put. + ULONG *pcStrings); // [OUT] put # put here. + + STDMETHODIMP GetParamForMethodIndex( // S_OK or error. + mdMethodDef md, // [IN] Method token. + ULONG ulParamSeq, // [IN] Parameter sequence. + mdParamDef *ppd); // [IN] Put Param token here. + + STDMETHODIMP GetCustomAttributeByName( // S_OK or error. + mdToken tkObj, // [IN] Object with Custom Attribute. + LPCWSTR szName, // [IN] Name of desired Custom Attribute. + const void **ppData, // [OUT] Put pointer to data here. + ULONG *pcbData); // [OUT] Put size of data here. + + STDMETHODIMP EnumCustomAttributes( // S_OK or error. + HCORENUM *phEnum, // [IN, OUT] COR enumerator. + mdToken tk, // [IN] Token to scope the enumeration, 0 for all. + mdToken tkType, // [IN] Type of interest, 0 for all. + mdCustomAttribute rCustomAttributes[], // [OUT] Put custom attribute tokens here. + ULONG cMax, // [IN] Size of rCustomAttributes. + ULONG *pcCustomAttributes); // [OUT, OPTIONAL] Put count of token values here. + + STDMETHODIMP GetCustomAttributeProps( // S_OK or error. + mdCustomAttribute cv, // [IN] CustomAttribute token. + mdToken *ptkObj, // [OUT, OPTIONAL] Put object token here. + mdToken *ptkType, // [OUT, OPTIONAL] Put AttrType token here. + void const **ppBlob, // [OUT, OPTIONAL] Put pointer to data here. + ULONG *pcbSize); // [OUT, OPTIONAL] Put size of date here. + + STDMETHODIMP FindTypeRef( // S_OK or error. + mdToken tkResolutionScope, // ResolutionScope. + LPCWSTR szName, // [IN] TypeRef name. + mdTypeRef *ptr); // [OUT] matching TypeRef. + + STDMETHODIMP GetMemberProps( + mdToken mb, // The member for which to get props. + mdTypeDef *pClass, // Put member's class here. + __out_ecount_opt (cchMember) LPWSTR szMember, // Put member's name here. + ULONG cchMember, // Size of szMember buffer in wide chars. + ULONG *pchMember, // Put actual size here + DWORD *pdwAttr, // Put flags here. + PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to the blob value of meta data + ULONG *pcbSigBlob, // [OUT] actual size of signature blob + ULONG *pulCodeRVA, // [OUT] codeRVA + DWORD *pdwImplFlags, // [OUT] Impl. Flags + DWORD *pdwCPlusTypeFlag, // [OUT] flag for value type. selected ELEMENT_TYPE_* + UVCP_CONSTANT *ppValue, // [OUT] constant value + ULONG *pcbValue); // [OUT] size of constant value + + STDMETHODIMP GetFieldProps( + mdFieldDef mb, // The field for which to get props. + mdTypeDef *pClass, // Put field's class here. + __out_ecount_opt (cchField) LPWSTR szField, // Put field's name here. + ULONG cchField, // Size of szField buffer in wide chars. + ULONG *pchField, // Put actual size here + DWORD *pdwAttr, // Put flags here. + PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to the blob value of meta data + ULONG *pcbSigBlob, // [OUT] actual size of signature blob + DWORD *pdwCPlusTypeFlag, // [OUT] flag for value type. selected ELEMENT_TYPE_* + UVCP_CONSTANT *ppValue, // [OUT] constant value + ULONG *pcbValue); // [OUT] size of constant value + + STDMETHODIMP GetPropertyProps( // S_OK, S_FALSE, or error. + mdProperty prop, // [IN] property token + mdTypeDef *pClass, // [OUT] typedef containing the property declarion. + LPCWSTR szProperty, // [OUT] Property name + ULONG cchProperty, // [IN] the count of wchar of szProperty + ULONG *pchProperty, // [OUT] actual count of wchar for property name + DWORD *pdwPropFlags, // [OUT] property flags. + PCCOR_SIGNATURE *ppvSig, // [OUT] property type. pointing to meta data internal blob + ULONG *pbSig, // [OUT] count of bytes in *ppvSig + DWORD *pdwCPlusTypeFlag, // [OUT] flag for value type. selected ELEMENT_TYPE_* + UVCP_CONSTANT *ppDefaultValue, // [OUT] constant value + ULONG *pcbValue, // [OUT] size of constant value + mdMethodDef *pmdSetter, // [OUT] setter method of the property + mdMethodDef *pmdGetter, // [OUT] getter method of the property + mdMethodDef rmdOtherMethod[], // [OUT] other method of the property + ULONG cMax, // [IN] size of rmdOtherMethod + ULONG *pcOtherMethod); // [OUT] total number of other method of this property + + STDMETHODIMP GetParamProps( // S_OK or error. + mdParamDef tk, // [IN]The Parameter. + mdMethodDef *pmd, // [OUT] Parent Method token. + ULONG *pulSequence, // [OUT] Parameter sequence. + __out_ecount_opt (cchName) LPWSTR szName, // [OUT] Put name here. + ULONG cchName, // [OUT] Size of name buffer. + ULONG *pchName, // [OUT] Put actual size of name here. + DWORD *pdwAttr, // [OUT] Put flags here. + DWORD *pdwCPlusTypeFlag, // [OUT] Flag for value type. selected ELEMENT_TYPE_*. + UVCP_CONSTANT *ppValue, // [OUT] Constant value. + ULONG *pcbValue); // [OUT] size of constant value + + STDMETHODIMP_(BOOL) IsValidToken( // True or False. + mdToken tk); // [IN] Given token. + + STDMETHODIMP GetNestedClassProps( // S_OK or error. + mdTypeDef tdNestedClass, // [IN] NestedClass token. + mdTypeDef *ptdEnclosingClass); // [OUT] EnclosingClass token. + + STDMETHODIMP GetNativeCallConvFromSig( // S_OK or error. + void const *pvSig, // [IN] Pointer to signature. + ULONG cbSig, // [IN] Count of signature bytes. + ULONG *pCallConv); // [OUT] Put calling conv here (see CorPinvokemap). + + STDMETHODIMP IsGlobal( // S_OK or error. + mdToken pd, // [IN] Type, Field, or Method token. + int *pbGlobal); // [OUT] Put 1 if global, 0 otherwise. + +//***************************************************************************** +// IMetaDataImport2 methods +//***************************************************************************** + STDMETHODIMP GetGenericParamProps( // S_OK or error. + mdGenericParam gp, // [IN] GenericParam + ULONG *pulParamSeq, // [OUT] Index of the type parameter + DWORD *pdwParamFlags, // [OUT] Flags, for future use (e.g. variance) + mdToken *ptOwner, // [OUT] Owner (TypeDef or MethodDef) + DWORD *reserved, // [OUT] For future use (e.g. non-type parameters) + __out_ecount_opt (cchName) LPWSTR wzname, // [OUT] Put name here + ULONG cchName, // [IN] Size of buffer + ULONG *pchName); // [OUT] Put size of name (wide chars) here. + + STDMETHODIMP GetGenericParamConstraintProps( // S_OK or error. + mdGenericParamConstraint gpc, // [IN] GenericParamConstraint + mdGenericParam *ptGenericParam, // [OUT] GenericParam that is constrained + mdToken *ptkConstraintType); // [OUT] TypeDef/Ref/Spec constraint + + STDMETHODIMP GetMethodSpecProps( + mdMethodSpec mi, // [IN] The method instantiation + mdToken *tkParent, // [OUT] MethodDef or MemberRef + PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to the blob value of meta data + ULONG *pcbSigBlob); // [OUT] actual size of signature blob + + STDMETHODIMP EnumGenericParams( // S_OK or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdToken tk, // [IN] TypeDef or MethodDef whose generic parameters are requested + mdGenericParam rGenericParams[], // [OUT] Put GenericParams here. + ULONG cMax, // [IN] Max GenericParams to put. + ULONG *pcGenericParams); // [OUT] Put # put here. + + STDMETHODIMP EnumGenericParamConstraints( // S_OK or error. + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdGenericParam tk, // [IN] GenericParam whose constraints are requested + mdGenericParamConstraint rGenericParamConstraints[], // [OUT] Put GenericParamConstraints here. + ULONG cMax, // [IN] Max GenericParamConstraints to put. + ULONG *pcGenericParamConstraints); // [OUT] Put # put here. + + STDMETHODIMP EnumMethodSpecs( + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdToken tk, // [IN] MethodDef or MemberRef whose MethodSpecs are requested + mdMethodSpec rMethodSpecs[], // [OUT] Put MethodSpecs here. + ULONG cMax, // [IN] Max tokens to put. + ULONG *pcMethodSpecs); // [OUT] Put actual count here. + + STDMETHODIMP GetPEKind( // S_OK or error. + DWORD* pdwPEKind, // [OUT] The kind of PE (0 - not a PE) + DWORD* pdwMAchine); // [OUT] Machine as defined in NT header + + STDMETHODIMP GetVersionString( // S_OK or error. + __out_ecount_opt (cchBufSize) LPWSTR pwzBuf, // [OUT] Put version string here. + DWORD cchBufSize, // [IN] size of the buffer, in wide chars + DWORD *pchBufSize); // [OUT] Size of the version string, wide chars, including terminating nul. + +//***************************************************************************** +// IMetaDataAssemblyImport +//***************************************************************************** + STDMETHODIMP GetAssemblyProps( // S_OK or error. + mdAssembly mda, // [IN] The Assembly for which to get the properties. + const void **ppbPublicKey, // [OUT] Pointer to the public key. + ULONG *pcbPublicKey, // [OUT] Count of bytes in the public key. + ULONG *pulHashAlgId, // [OUT] Hash Algorithm. + __out_ecount_part_opt(cchName, *pchName) LPWSTR szName, // [OUT] Buffer to fill with assembly's simply name. + ULONG cchName, // [IN] Size of buffer in wide chars. + ULONG *pchName, // [OUT] Actual # of wide chars in name. + ASSEMBLYMETADATA *pMetaData, // [OUT] Assembly MetaData. + DWORD *pdwAssemblyFlags); // [OUT] Flags. + + STDMETHODIMP GetAssemblyRefProps( // S_OK or error. + mdAssemblyRef mdar, // [IN] The AssemblyRef for which to get the properties. + const void **ppbPublicKeyOrToken, // [OUT] Pointer to the public key or token. + ULONG *pcbPublicKeyOrToken, // [OUT] Count of bytes in the public key or token. + __out_ecount_part_opt(cchName, *pchName)LPWSTR szName, // [OUT] Buffer to fill with name. + ULONG cchName, // [IN] Size of buffer in wide chars. + ULONG *pchName, // [OUT] Actual # of wide chars in name. + ASSEMBLYMETADATA *pMetaData, // [OUT] Assembly MetaData. + const void **ppbHashValue, // [OUT] Hash blob. + ULONG *pcbHashValue, // [OUT] Count of bytes in the hash blob. + DWORD *pdwAssemblyRefFlags); // [OUT] Flags. + + STDMETHODIMP GetFileProps( // S_OK or error. + mdFile mdf, // [IN] The File for which to get the properties. + __out_ecount_part_opt(cchName, *pchName) LPWSTR szName, // [OUT] Buffer to fill with name. + ULONG cchName, // [IN] Size of buffer in wide chars. + ULONG *pchName, // [OUT] Actual # of wide chars in name. + const void **ppbHashValue, // [OUT] Pointer to the Hash Value Blob. + ULONG *pcbHashValue, // [OUT] Count of bytes in the Hash Value Blob. + DWORD *pdwFileFlags); // [OUT] Flags. + + STDMETHODIMP GetExportedTypeProps( // S_OK or error. + mdExportedType mdct, // [IN] The ExportedType for which to get the properties. + __out_ecount_part_opt(cchName, *pchName) LPWSTR szName, // [OUT] Buffer to fill with name. + ULONG cchName, // [IN] Size of buffer in wide chars. + ULONG *pchName, // [OUT] Actual # of wide chars in name. + mdToken *ptkImplementation, // [OUT] mdFile or mdAssemblyRef that provides the ExportedType. + mdTypeDef *ptkTypeDef, // [OUT] TypeDef token within the file. + DWORD *pdwExportedTypeFlags); // [OUT] Flags. + + STDMETHODIMP GetManifestResourceProps( // S_OK or error. + mdManifestResource mdmr, // [IN] The ManifestResource for which to get the properties. + __out_ecount_part_opt(cchName, *pchName)LPWSTR szName, // [OUT] Buffer to fill with name. + ULONG cchName, // [IN] Size of buffer in wide chars. + ULONG *pchName, // [OUT] Actual # of wide chars in name. + mdToken *ptkImplementation, // [OUT] mdFile or mdAssemblyRef that provides the ExportedType. + DWORD *pdwOffset, // [OUT] Offset to the beginning of the resource within the file. + DWORD *pdwResourceFlags); // [OUT] Flags. + + STDMETHODIMP EnumAssemblyRefs( // S_OK or error + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdAssemblyRef rAssemblyRefs[], // [OUT] Put AssemblyRefs here. + ULONG cMax, // [IN] Max AssemblyRefs to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumFiles( // S_OK or error + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdFile rFiles[], // [OUT] Put Files here. + ULONG cMax, // [IN] Max Files to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumExportedTypes( // S_OK or error + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdExportedType rExportedTypes[], // [OUT] Put ExportedTypes here. + ULONG cMax, // [IN] Max ExportedTypes to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP EnumManifestResources( // S_OK or error + HCORENUM *phEnum, // [IN|OUT] Pointer to the enum. + mdManifestResource rManifestResources[], // [OUT] Put ManifestResources here. + ULONG cMax, // [IN] Max Resources to put. + ULONG *pcTokens); // [OUT] Put # put here. + + STDMETHODIMP FindExportedTypeByName( // S_OK or error + LPCWSTR szName, // [IN] Name of the ExportedType. + mdExportedType tkEnclosingType, // [IN] Enclosing ExportedType. + mdExportedType *ptkExportedType); // [OUT] Put the ExportedType token here. + + STDMETHODIMP FindManifestResourceByName(// S_OK or error + LPCWSTR szName, // [IN] Name of the ManifestResource. + mdManifestResource *ptkManifestResource); // [OUT] Put the ManifestResource token here. + + STDMETHODIMP GetAssemblyFromScope( // S_OK or error + mdAssembly *ptkAssembly); // [OUT] Put token here. + + // This uses Fusion to lookup, so it's E_NOTIMPL in the standalone versions. + STDMETHODIMP FindAssembliesByName( // S_OK or error + LPCWSTR szAppBase, // [IN] optional - can be NULL + LPCWSTR szPrivateBin, // [IN] optional - can be NULL + LPCWSTR szAssemblyName, // [IN] required - this is the assembly you are requesting + IUnknown *ppIUnk[], // [OUT] put IMetaDataAssemblyImport pointers here + ULONG cMax, // [IN] The max number to put + ULONG *pcAssemblies); // [OUT] The number of assemblies returned. + +#ifdef FEATURE_METADATA_EMIT +//***************************************************************************** +// IMetaDataEmit +//***************************************************************************** + STDMETHODIMP DefineMethod( // S_OK or error. + mdTypeDef td, // Parent TypeDef + LPCWSTR szName, // Name of member + DWORD dwMethodFlags, // Member attributes + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + ULONG ulCodeRVA, + DWORD dwImplFlags, + mdMethodDef *pmd); // Put member token here + + STDMETHODIMP DefineMethodImpl( // S_OK or error. + mdTypeDef td, // [IN] The class implementing the method + mdToken tkBody, // [IN] Method body, MethodDef or MethodRef + mdToken tkDecl); // [IN] Method declaration, MethodDef or MethodRef + + STDMETHODIMP SetMethodImplFlags( // [IN] S_OK or error. + mdMethodDef md, // [IN] Method for which to set impl flags + DWORD dwImplFlags); + + STDMETHODIMP SetFieldRVA( // [IN] S_OK or error. + mdFieldDef fd, // [IN] Field for which to set offset + ULONG ulRVA); // [IN] The offset + + STDMETHODIMP DefineTypeRefByName( // S_OK or error. + mdToken tkResolutionScope, // [IN] ModuleRef or AssemblyRef. + LPCWSTR szName, // [IN] Name of the TypeRef. + mdTypeRef *ptr); // [OUT] Put TypeRef token here. + + STDMETHODIMP DefineImportType( // S_OK or error. + IMetaDataAssemblyImport *pAssemImport, // [IN] Assemby containing the TypeDef. + const void *pbHashValue, // [IN] Hash Blob for Assembly. + ULONG cbHashValue, // [IN] Count of bytes. + IMetaDataImport *pImport, // [IN] Scope containing the TypeDef. + mdTypeDef tdImport, // [IN] The imported TypeDef. + IMetaDataAssemblyEmit *pAssemEmit, // [IN] Assembly into which the TypeDef is imported. + mdTypeRef *ptr); // [OUT] Put TypeRef token here. + + STDMETHODIMP DefineMemberRef( // S_OK or error + mdToken tkImport, // [IN] ClassRef or ClassDef importing a member. + LPCWSTR szName, // [IN] member's name + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdMemberRef *pmr); // [OUT] memberref token + + STDMETHODIMP DefineImportMember( // S_OK or error. + IMetaDataAssemblyImport *pAssemImport, // [IN] Assemby containing the Member. + const void *pbHashValue, // [IN] Hash Blob for Assembly. + ULONG cbHashValue, // [IN] Count of bytes. + IMetaDataImport *pImport, // [IN] Import scope, with member. + mdToken mbMember, // [IN] Member in import scope. + IMetaDataAssemblyEmit *pAssemEmit, // [IN] Assembly into which the Member is imported. + mdToken tkImport, // [IN] Classref or classdef in emit scope. + mdMemberRef *pmr); // [OUT] Put member ref here. + + STDMETHODIMP DefineEvent( + mdTypeDef td, // [IN] the class/interface on which the event is being defined + LPCWSTR szEvent, // [IN] Name of the event + DWORD dwEventFlags, // [IN] CorEventAttr + mdToken tkEventType, // [IN] a reference (mdTypeRef or mdTypeRef(to the Event class + mdMethodDef mdAddOn, // [IN] required add method + mdMethodDef mdRemoveOn, // [IN] required remove method + mdMethodDef mdFire, // [IN] optional fire method + mdMethodDef rmdOtherMethods[], // [IN] optional array of other methods associate with the event + mdEvent *pmdEvent); // [OUT] output event token + + STDMETHODIMP SetClassLayout( + mdTypeDef td, // [IN] typedef + DWORD dwPackSize, // [IN] packing size specified as 1, 2, 4, 8, or 16 + COR_FIELD_OFFSET rFieldOffsets[], // [IN] array of layout specification + ULONG ulClassSize); // [IN] size of the class + + STDMETHODIMP DeleteClassLayout( + mdTypeDef td); // [IN] typdef token + + STDMETHODIMP SetFieldMarshal( + mdToken tk, // [IN] given a fieldDef or paramDef token + PCCOR_SIGNATURE pvNativeType, // [IN] native type specification + ULONG cbNativeType); // [IN] count of bytes of pvNativeType + + STDMETHODIMP DeleteFieldMarshal( + mdToken tk); // [IN] fieldDef or paramDef token to be deleted. + + STDMETHODIMP DefinePermissionSet( + mdToken tk, // [IN] the object to be decorated. + DWORD dwAction, // [IN] CorDeclSecurity. + void const *pvPermission, // [IN] permission blob. + ULONG cbPermission, // [IN] count of bytes of pvPermission. + mdPermission *ppm); // [OUT] returned permission token. + + STDMETHODIMP SetRVA( // [IN] S_OK or error. + mdToken md, // [IN] MethodDef for which to set offset + ULONG ulRVA); // [IN] The offset#endif + + STDMETHODIMP GetTokenFromSig( // [IN] S_OK or error. + PCCOR_SIGNATURE pvSig, // [IN] Signature to define. + ULONG cbSig, // [IN] Size of signature data. + mdSignature *pmsig); // [OUT] returned signature token. + + STDMETHODIMP DefineModuleRef( // S_OK or error. + LPCWSTR szName, // [IN] DLL name + mdModuleRef *pmur); // [OUT] returned module ref token + + STDMETHODIMP SetParent( // S_OK or error. + mdMemberRef mr, // [IN] Token for the ref to be fixed up. + mdToken tk); // [IN] The ref parent. + + STDMETHODIMP GetTokenFromTypeSpec( // S_OK or error. + PCCOR_SIGNATURE pvSig, // [IN] ArraySpec Signature to define. + ULONG cbSig, // [IN] Size of signature data. + mdTypeSpec *ptypespec); // [OUT] returned TypeSpec token. + + STDMETHODIMP SaveToMemory( // S_OK or error. + void *pbData, // [OUT] Location to write data. + ULONG cbData); // [IN] Max size of data buffer. + + STDMETHODIMP DefineUserString( // S_OK or error. + LPCWSTR szString, // [IN] User literal string. + ULONG cchString, // [IN] Length of string. + mdString *pstk); // [OUT] String token. + + STDMETHODIMP DeleteToken( // Return code. + mdToken tkObj); // [IN] The token to be deleted + + STDMETHODIMP SetTypeDefProps( // S_OK or error. + mdTypeDef td, // [IN] The TypeDef. + DWORD dwTypeDefFlags, // [IN] TypeDef flags. + mdToken tkExtends, // [IN] Base TypeDef or TypeRef. + mdToken rtkImplements[]); // [IN] Implemented interfaces. + + STDMETHODIMP DefineNestedType( // S_OK or error. + LPCWSTR szTypeDef, // [IN] Name of TypeDef + DWORD dwTypeDefFlags, // [IN] CustomAttribute flags + mdToken tkExtends, // [IN] extends this TypeDef or typeref + mdToken rtkImplements[], // [IN] Implements interfaces + mdTypeDef tdEncloser, // [IN] TypeDef token of the enclosing type. + mdTypeDef *ptd); // [OUT] Put TypeDef token here + + STDMETHODIMP SetMethodProps( // S_OK or error. + mdMethodDef md, // [IN] The MethodDef. + DWORD dwMethodFlags, // [IN] Method attributes. + ULONG ulCodeRVA, // [IN] Code RVA. + DWORD dwImplFlags); // [IN] MethodImpl flags. + + STDMETHODIMP SetEventProps( // S_OK or error. + mdEvent ev, // [IN] The event token. + DWORD dwEventFlags, // [IN] CorEventAttr. + mdToken tkEventType, // [IN] A reference (mdTypeRef or mdTypeRef) to the Event class. + mdMethodDef mdAddOn, // [IN] Add method. + mdMethodDef mdRemoveOn, // [IN] Remove method. + mdMethodDef mdFire, // [IN] Fire method. + mdMethodDef rmdOtherMethods[]); // [IN] Array of other methods associated with the event. + + STDMETHODIMP SetPermissionSetProps( // S_OK or error. + mdToken tk, // [IN] The object to be decorated. + DWORD dwAction, // [IN] CorDeclSecurity. + void const *pvPermission, // [IN] Permission blob. + ULONG cbPermission, // [IN] Count of bytes of pvPermission. + mdPermission *ppm); // [OUT] Permission token. + + STDMETHODIMP DefinePinvokeMap( // Return code. + mdToken tk, // [IN] FieldDef or MethodDef. + DWORD dwMappingFlags, // [IN] Flags used for mapping. + LPCWSTR szImportName, // [IN] Import name. + mdModuleRef mrImportDLL); // [IN] ModuleRef token for the target DLL. + + STDMETHODIMP SetPinvokeMap( // Return code. + mdToken tk, // [IN] FieldDef or MethodDef. + DWORD dwMappingFlags, // [IN] Flags used for mapping. + LPCWSTR szImportName, // [IN] Import name. + mdModuleRef mrImportDLL); // [IN] ModuleRef token for the target DLL. + + STDMETHODIMP DeletePinvokeMap( // Return code. + mdToken tk); // [IN]FieldDef or MethodDef. + + STDMETHODIMP DefineCustomAttribute( // Return code. + mdToken tkOwner, // [IN] The object to put the value on. + mdToken tkCtor, // [IN] Constructor of the CustomAttribute type (MemberRef/MethodDef). + void const *pCustomAttribute, // [IN] The custom value data. + ULONG cbCustomAttribute, // [IN] The custom value data length. + mdCustomAttribute *pcv); // [OUT] The custom value token value on return. + + STDMETHODIMP SetCustomAttributeValue( // Return code. + mdCustomAttribute pcv, // [IN] The custom value token whose value to replace. + void const *pCustomAttribute, // [IN] The custom value data. + ULONG cbCustomAttribute); // [IN] The custom value data length. + + STDMETHODIMP DefineField( // S_OK or error. + mdTypeDef td, // Parent TypeDef + LPCWSTR szName, // Name of member + DWORD dwFieldFlags, // Member attributes + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + DWORD dwCPlusTypeFlag, // [IN] flag for value type. selected ELEMENT_TYPE_* + void const *pValue, // [IN] constant value + ULONG cchValue, // [IN] size of constant value (string, in wide chars). + mdFieldDef *pmd); // [OUT] Put member token here + + STDMETHODIMP DefineProperty( + mdTypeDef td, // [IN] the class/interface on which the property is being defined + LPCWSTR szProperty, // [IN] Name of the property + DWORD dwPropFlags, // [IN] CorPropertyAttr + PCCOR_SIGNATURE pvSig, // [IN] the required type signature + ULONG cbSig, // [IN] the size of the type signature blob + DWORD dwCPlusTypeFlag, // [IN] flag for value type. selected ELEMENT_TYPE_* + void const *pValue, // [IN] constant value + ULONG cchValue, // [IN] size of constant value (string, in wide chars). + mdMethodDef mdSetter, // [IN] optional setter of the property + mdMethodDef mdGetter, // [IN] optional getter of the property + mdMethodDef rmdOtherMethods[], // [IN] an optional array of other methods + mdProperty *pmdProp); // [OUT] output property token + + STDMETHODIMP DefineParam( + mdMethodDef md, // [IN] Owning method + ULONG ulParamSeq, // [IN] Which param + LPCWSTR szName, // [IN] Optional param name + DWORD dwParamFlags, // [IN] Optional param flags + DWORD dwCPlusTypeFlag, // [IN] flag for value type. selected ELEMENT_TYPE_* + void const *pValue, // [IN] constant value + ULONG cchValue, // [IN] size of constant value (string, in wide chars). + mdParamDef *ppd); // [OUT] Put param token here + + STDMETHODIMP SetFieldProps( // S_OK or error. + mdFieldDef fd, // [IN] The FieldDef. + DWORD dwFieldFlags, // [IN] Field attributes. + DWORD dwCPlusTypeFlag, // [IN] Flag for the value type, selected ELEMENT_TYPE_* + void const *pValue, // [IN] Constant value. + ULONG cchValue); // [IN] size of constant value (string, in wide chars). + + STDMETHODIMP SetPropertyProps( // S_OK or error. + mdProperty pr, // [IN] Property token. + DWORD dwPropFlags, // [IN] CorPropertyAttr. + DWORD dwCPlusTypeFlag, // [IN] Flag for value type, selected ELEMENT_TYPE_* + void const *pValue, // [IN] Constant value. + ULONG cchValue, // [IN] size of constant value (string, in wide chars). + mdMethodDef mdSetter, // [IN] Setter of the property. + mdMethodDef mdGetter, // [IN] Getter of the property. + mdMethodDef rmdOtherMethods[]); // [IN] Array of other methods. + + STDMETHODIMP SetParamProps( // Return code. + mdParamDef pd, // [IN] Param token. + LPCWSTR szName, // [IN] Param name. + DWORD dwParamFlags, // [IN] Param flags. + DWORD dwCPlusTypeFlag, // [IN] Flag for value type. selected ELEMENT_TYPE_*. + void const *pValue, // [OUT] Constant value. + ULONG cchValue); // [IN] size of constant value (string, in wide chars). + + STDMETHODIMP ApplyEditAndContinue( // S_OK or error. + IUnknown *pImport); // [IN] Metadata from the delta PE. + + // Specialized Custom Attributes for security. + STDMETHODIMP DefineSecurityAttributeSet(// Return code. + mdToken tkObj, // [IN] Class or method requiring security attributes. + COR_SECATTR rSecAttrs[], // [IN] Array of security attribute descriptions. + ULONG cSecAttrs, // [IN] Count of elements in above array. + ULONG *pulErrorAttr); // [OUT] On error, index of attribute causing problem. + + STDMETHODIMP TranslateSigWithScope( + IMetaDataAssemblyImport *pAssemImport, // [IN] assembly importing interface + const void *pbHashValue, // [IN] Hash Blob for Assembly. + ULONG cbHashValue, // [IN] Count of bytes. + IMetaDataImport *import, // [IN] importing interface + PCCOR_SIGNATURE pbSigBlob, // [IN] signature in the importing scope + ULONG cbSigBlob, // [IN] count of bytes of signature + IMetaDataAssemblyEmit *pAssemEmti, // [IN] emit assembly interface + IMetaDataEmit *emit, // [IN] emit interface + PCOR_SIGNATURE pvTranslatedSig, // [OUT] buffer to hold translated signature + ULONG cbTranslatedSigMax, + ULONG *pcbTranslatedSig); // [OUT] count of bytes in the translated signature + +//***************************************************************************** +// IMetaDataEmit2 methods +//***************************************************************************** + STDMETHODIMP SetModuleProps( // S_OK or error. + LPCWSTR szName); // [IN] If not NULL, the name to set. + + STDMETHODIMP Save( // S_OK or error. + LPCWSTR szFile, // [IN] The filename to save to. + DWORD dwSaveFlags); // [IN] Flags for the save. + + STDMETHODIMP SaveToStream( // S_OK or error. + IStream *pIStream, // [IN] A writable stream to save to. + DWORD dwSaveFlags); // [IN] Flags for the save. + + STDMETHODIMP GetSaveSize( // S_OK or error. + CorSaveSize fSave, // [IN] cssAccurate or cssQuick. + DWORD *pdwSaveSize); // [OUT] Put the size here. + + STDMETHODIMP Merge( // S_OK or error. + IMetaDataImport *pImport, // [IN] The scope to be merged. + IMapToken *pHostMapToken, // [IN] Host IMapToken interface to receive token remap notification + IUnknown *pHandler); // [IN] An object to receive to receive error notification. + + STDMETHODIMP MergeEnd(); // S_OK or error. + + STDMETHODIMP DefineMethodSpec( // S_OK or error + mdToken tkImport, // [IN] MethodDef or MemberRef + PCCOR_SIGNATURE pvSigBlob, // [IN] point to a blob value of COM+ signature + ULONG cbSigBlob, // [IN] count of bytes in the signature blob + mdMethodSpec *pmi); // [OUT] method instantiation token + + STDMETHODIMP DefineTypeDef( // S_OK or error. + LPCWSTR szTypeDef, // [IN] Name of TypeDef + DWORD dwTypeDefFlags, // [IN] CustomAttribute flags + mdToken tkExtends, // [IN] extends this TypeDef or typeref + mdToken rtkImplements[], // [IN] Implements interfaces + mdTypeDef *ptd); // [OUT] Put TypeDef token here + + STDMETHODIMP SetHandler( // S_OK. + IUnknown *pUnk); // [IN] The new error handler. + + STDMETHODIMP GetDeltaSaveSize( // S_OK or error. + CorSaveSize fSave, // [IN] cssAccurate or cssQuick. + DWORD *pdwSaveSize); // [OUT] Put the size here. + + STDMETHODIMP SaveDelta( // S_OK or error. + LPCWSTR szFile, // [IN] The filename to save to. + DWORD dwSaveFlags); // [IN] Flags for the save. + + STDMETHODIMP SaveDeltaToStream( // S_OK or error. + IStream *pIStream, // [IN] A writable stream to save to. + DWORD dwSaveFlags); // [IN] Flags for the save. + + STDMETHODIMP SaveDeltaToMemory( // S_OK or error. + void *pbData, // [OUT] Location to write data. + ULONG cbData); // [IN] Max size of data buffer. + + STDMETHODIMP ResetENCLog(); // S_OK or error. + + STDMETHODIMP DefineGenericParam( // S_OK or error. + mdToken tk, // [IN] TypeDef or MethodDef + ULONG ulParamSeq, // [IN] Index of the type parameter + DWORD dwParamFlags, // [IN] Flags, for future use (e.g. variance) + LPCWSTR szname, // [IN] Name + DWORD reserved, // [IN] For future use (e.g. non-type parameters) + mdToken rtkConstraints[], // [IN] Array of type constraints (TypeDef,TypeRef,TypeSpec) + mdGenericParam *pgp); // [OUT] Put GenericParam token here + + STDMETHODIMP SetGenericParamProps( // S_OK or error. + mdGenericParam gp, // [IN] GenericParam + DWORD dwParamFlags, // [IN] Flags, for future use (e.g. variance) + LPCWSTR szName, // [IN] Optional name + DWORD reserved, // [IN] For future use (e.g. non-type parameters) + mdToken rtkConstraints[]); // [IN] Array of type constraints (TypeDef,TypeRef,TypeSpec) + +//***************************************************************************** +// IMetaDataAssemblyEmit +//***************************************************************************** + STDMETHODIMP DefineAssembly( // S_OK or error. + const void *pbPublicKey, // [IN] Public key of the assembly. + ULONG cbPublicKey, // [IN] Count of bytes in the public key. + ULONG ulHashAlgId, // [IN] Hash Algorithm. + LPCWSTR szName, // [IN] Name of the assembly. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + DWORD dwAssemblyFlags, // [IN] Flags. + mdAssembly *pma); // [OUT] Returned Assembly token. + + STDMETHODIMP DefineAssemblyRef( // S_OK or error. + const void *pbPublicKeyOrToken, // [IN] Public key or token of the assembly. + ULONG cbPublicKeyOrToken, // [IN] Count of bytes in the public key or token. + LPCWSTR szName, // [IN] Name of the assembly being referenced. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwAssemblyRefFlags, // [IN] Token for Execution Location. + mdAssemblyRef *pmar); // [OUT] Returned AssemblyRef token. + + STDMETHODIMP DefineFile( // S_OK or error. + LPCWSTR szName, // [IN] Name of the file. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwFileFlags, // [IN] Flags. + mdFile *pmf); // [OUT] Returned File token. + + STDMETHODIMP DefineExportedType( // S_OK or error. + LPCWSTR szName, // [IN] Name of the Com Type. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the ExportedType. + mdTypeDef tkTypeDef, // [IN] TypeDef token within the file. + DWORD dwExportedTypeFlags, // [IN] Flags. + mdExportedType *pmct); // [OUT] Returned ExportedType token. + + STDMETHODIMP DefineManifestResource( // S_OK or error. + LPCWSTR szName, // [IN] Name of the resource. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the resource. + DWORD dwOffset, // [IN] Offset to the beginning of the resource within the file. + DWORD dwResourceFlags, // [IN] Flags. + mdManifestResource *pmmr); // [OUT] Returned ManifestResource token. + + STDMETHODIMP SetAssemblyProps( // S_OK or error. + mdAssembly pma, // [IN] Assembly token. + const void *pbPublicKey, // [IN] Public key of the assembly. + ULONG cbPublicKey, // [IN] Count of bytes in the public key. + ULONG ulHashAlgId, // [IN] Hash Algorithm. + LPCWSTR szName, // [IN] Name of the assembly. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + DWORD dwAssemblyFlags); // [IN] Flags. + + STDMETHODIMP SetAssemblyRefProps( // S_OK or error. + mdAssemblyRef ar, // [IN] AssemblyRefToken. + const void *pbPublicKeyOrToken, // [IN] Public key or token of the assembly. + ULONG cbPublicKeyOrToken, // [IN] Count of bytes in the public key or token. + LPCWSTR szName, // [IN] Name of the assembly being referenced. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwAssemblyRefFlags); // [IN] Token for Execution Location. + + STDMETHODIMP SetFileProps( // S_OK or error. + mdFile file, // [IN] File token. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwFileFlags); // [IN] Flags. + + STDMETHODIMP SetExportedTypeProps( // S_OK or error. + mdExportedType ct, // [IN] ExportedType token. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the ExportedType. + mdTypeDef tkTypeDef, // [IN] TypeDef token within the file. + DWORD dwExportedTypeFlags); // [IN] Flags. + + STDMETHODIMP SetManifestResourceProps( // S_OK or error. + mdManifestResource mr, // [IN] ManifestResource token. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the resource. + DWORD dwOffset, // [IN] Offset to the beginning of the resource within the file. + DWORD dwResourceFlags); // [IN] Flags. + +#endif //FEATURE_METADATA_EMIT + +#ifdef FEATURE_METADATA_VALIDATOR +//***************************************************************************** +// IMetaDataValidator +//***************************************************************************** + + STDMETHODIMP ValidatorInit( + DWORD dwModuleType, // [IN] Specifies whether the module is a PE file or an obj. + IUnknown * pUnk); // [IN] Validation error handler. + + STDMETHODIMP ValidateMetaData(); +#endif //FEATURE_METADATA_VALIDATOR + +#ifdef FEATURE_METADATA_EMIT_ALL +//***************************************************************************** +// IMetaDataFilter +//***************************************************************************** + STDMETHODIMP UnmarkAll(); // unmark everything in a module + + STDMETHODIMP MarkToken( + mdToken tk); // [IN] Token to be marked + + STDMETHODIMP IsTokenMarked( + mdToken tk, // [IN] Token to be checked + BOOL *pIsMarked); // [OUT] TRUE if token is marked + +#endif //FEATURE_METADATA_EMIT_ALL + +#ifdef FEATURE_METADATA_INTERNAL_APIS + +//***************************************************************************** +// IMetaDataEmitHelper +//***************************************************************************** + STDMETHODIMP DefineMethodSemanticsHelper( + mdToken tkAssociation, // [IN] property or event token + DWORD dwFlags, // [IN] semantics + mdMethodDef md); // [IN] method to associated with + + STDMETHODIMP SetFieldLayoutHelper( // Return hresult. + mdFieldDef fd, // [IN] field to associate the layout info + ULONG ulOffset); // [IN] the offset for the field + + STDMETHODIMP DefineEventHelper( + mdTypeDef td, // [IN] the class/interface on which the event is being defined + LPCWSTR szEvent, // [IN] Name of the event + DWORD dwEventFlags, // [IN] CorEventAttr + mdToken tkEventType, // [IN] a reference (mdTypeRef or mdTypeRef) to the Event class + mdEvent *pmdEvent); // [OUT] output event token + + STDMETHODIMP AddDeclarativeSecurityHelper( + mdToken tk, // [IN] Parent token (typedef/methoddef) + DWORD dwAction, // [IN] Security action (CorDeclSecurity) + void const *pValue, // [IN] Permission set blob + DWORD cbValue, // [IN] Byte count of permission set blob + mdPermission*pmdPermission); // [OUT] Output permission token + + STDMETHODIMP SetResolutionScopeHelper( // Return hresult. + mdTypeRef tr, // [IN] TypeRef record to update + mdToken rs); // [IN] new ResolutionScope + + STDMETHODIMP SetManifestResourceOffsetHelper( // Return hresult. + mdManifestResource mr, // [IN] The manifest token + ULONG ulOffset); // [IN] new offset + + STDMETHODIMP SetTypeParent( // Return hresult. + mdTypeDef td, // [IN] Type definition + mdToken tkExtends); // [IN] parent type + + STDMETHODIMP AddInterfaceImpl( // Return hresult. + mdTypeDef td, // [IN] Type definition + mdToken tkInterface); // [IN] interface type + +//***************************************************************************** +// IMDInternalEmit +//***************************************************************************** + + STDMETHODIMP ChangeMvid( // S_OK or error. + REFGUID newMvid); // GUID to use as the MVID + + STDMETHOD(SetMDUpdateMode)( + ULONG updateMode, ULONG *pPreviousUpdateMode); + +//***************************************************************************** +// IMetaDataHelper +//***************************************************************************** + STDMETHODIMP GetMetadata( // Result. + ULONG ulSelect, // [IN] Selector. + void **ppData); // [OUT] Put pointer to data here. + + STDMETHODIMP_(IUnknown *) GetCachedInternalInterface(BOOL fWithLock); // S_OK or error + STDMETHODIMP SetCachedInternalInterface(IUnknown *pUnk); // S_OK or error + STDMETHODIMP SetReaderWriterLock(UTSemReadWrite * pSem) + { + _ASSERTE(m_pSemReadWrite == NULL); + m_pSemReadWrite = pSem; + INDEBUG(m_pStgdb->m_MiniMd.Debug_SetLock(m_pSemReadWrite);) + return NOERROR; + } + STDMETHODIMP_(UTSemReadWrite *) GetReaderWriterLock() { return m_pSemReadWrite; } + +#ifndef FEATURE_METADATA_EMIT + // This method is also part of IMetaDataEmit interface, do not declare it twice + STDMETHODIMP TranslateSigWithScope( + IMetaDataAssemblyImport *pAssemImport, // [IN] assembly importing interface + const void *pbHashValue, // [IN] Hash Blob for Assembly. + ULONG cbHashValue, // [IN] Count of bytes. + IMetaDataImport *import, // [IN] importing interface + PCCOR_SIGNATURE pbSigBlob, // [IN] signature in the importing scope + ULONG cbSigBlob, // [IN] count of bytes of signature + IMetaDataAssemblyEmit *pAssemEmti, // [IN] emit assembly interface + IMetaDataEmit *emit, // [IN] emit interface + PCOR_SIGNATURE pvTranslatedSig, // [OUT] buffer to hold translated signature + ULONG cbTranslatedSigMax, + ULONG *pcbTranslatedSig); // [OUT] count of bytes in the translated signature +#endif //!FEATURE_METADATA_EMIT + + //***************************************************************************** + // IGetIMDInternalImport methods + //***************************************************************************** + STDMETHOD(GetIMDInternalImport) ( + IMDInternalImport ** ppIMDInternalImport // [OUT] Buffer to receive IMDInternalImport* + ); + +#endif //FEATURE_METADATA_INTERNAL_APIS + +//***************************************************************************** +// IMetaDataTables +//***************************************************************************** + + // Fills size (*pcbStringsHeapSize) of internal strings heap (#String). + // Returns S_OK or error code. Fills *pcbStringsHeapSize with 0 on error. + // Implements public API code:IMetaDataTables::GetStringHeapSize. + STDMETHODIMP GetStringHeapSize( + __out ULONG *pcbStringsHeapSize); // [OUT] Size of the string heap. + + // Fills size (*pcbBlobsHeapSize) of blobs heap (#Blob). + // Returns S_OK or error code. Fills *pcbBlobsHeapSize with 0 on error. + // Implements public API code:IMetaDataTables::GetBlobHeapSize. + STDMETHODIMP GetBlobHeapSize( + __out ULONG *pcbBlobsHeapSize); // [OUT] Size of the blob heap. + + // Fills size (*pcbGuidsHeapSize) of guids heap (#GUID). + // Returns S_OK or error code. Fills *pcbGuidsHeapSize with 0 on error. + // Implements public API code:IMetaDataTables::GetGuidHeapSize. + STDMETHODIMP GetGuidHeapSize( + __out ULONG *pcbGuidsHeapSize); // [OUT] Size of the Guid heap. + + // Fills size (*pcbUserStringsHeapSize) of user strings heap (#US) (referenced from IL). + // Returns S_OK or error code. Fills *pcbUserStringsHeapSize with 0 on error. + // Implements public API code:IMetaDataTables::GetUserStringHeapSize. + // Backward compatibility: returns S_OK even if the string doesn't have odd number of bytes as specified + // in CLI ECMA specification. + STDMETHODIMP GetUserStringHeapSize( + __out ULONG *pcbUserStringsHeapSize); // [OUT] Size of the user string heap. + + // Implements public API code:IMetaDataTables::GetNumTables. + STDMETHODIMP GetNumTables( + __out ULONG *pcTables); // [OUT] Count of tables. + + // Implements public API code:IMetaDataTables::GetNumTables. + STDMETHODIMP GetTableIndex( + ULONG token, // [IN] Token for which to get table index. + __out ULONG *pixTbl); // [OUT] Put table index here. + + // Implements public API code:IMetaDataTables::GetTableInfo. + STDMETHODIMP GetTableInfo( + ULONG ixTbl, // [IN] Which table. + ULONG *pcbRow, // [OUT] Size of a row, bytes. + ULONG *pcRows, // [OUT] Number of rows. + ULONG *pcCols, // [OUT] Number of columns in each row. + ULONG *piKey, // [OUT] Key column, or -1 if none. + const char **ppName); // [OUT] Name of the table. + + // Implements public API code:IMetaDataTables::GetColumnInfo. + STDMETHODIMP GetColumnInfo( + ULONG ixTbl, // [IN] Which Table. + ULONG ixCol, // [IN] Which Column in the table. + ULONG *poCol, // [OUT] Offset of the column in the row. + ULONG *pcbCol, // [OUT] Size of a column, bytes. + ULONG *pType, // [OUT] Type of the column. + const char **ppName); // [OUT] Name of the Column. + + // Implements public API code:IMetaDataTables::GetCodedTokenInfo. + STDMETHODIMP GetCodedTokenInfo( + ULONG ixCdTkn, // [IN] Which kind of coded token. + ULONG *pcTokens, // [OUT] Count of tokens. + ULONG **ppTokens, // [OUT] List of tokens. + const char **ppName); // [OUT] Name of the CodedToken. + + // Implements public API code:IMetaDataTables::GetRow. + STDMETHODIMP GetRow( + ULONG ixTbl, // [IN] Which table. + ULONG rid, // [IN] Which row. + void **ppRow); // [OUT] Put pointer to row here. + + // Implements public API code:IMetaDataTables::GetColumn. + STDMETHODIMP GetColumn( + ULONG ixTbl, // [IN] Which table. + ULONG ixCol, // [IN] Which column. + ULONG rid, // [IN] Which row. + ULONG *pVal); // [OUT] Put the column contents here. + + //#GetString_IMetaDataTables + // Fills internal null-terminated string (*pszString) at index ixString from string heap (#String). + // Returns S_OK (even for index 0) or error code (if index is invalid, fills *pszString with NULL then). + // Implements public API code:IMetaDataTables::GetString. + STDMETHODIMP GetString( + ULONG ixString, // [IN] Value from a string column. + const char **pszString); // [OUT] Put a pointer to the string here. + + //#GetBlob_IMetaDataTables + // Fills blob entry (*ppvData of size *pcbDataSize) at index ixBlob from blob heap (#Blob). + // Returns S_OK (even for index 0) or error code (if index is invalid, fills NULL and o then). + // Implements public API code:IMetaDataTables::GetBlob. + STDMETHODIMP GetBlob( + ULONG ixBlob, // [IN] Value from a blob column. + ULONG *pcbDataSize, // [OUT] Put size of the blob here. + const void **ppvData); // [OUT] Put a pointer to the blob here. + + //#GetGuid_IMetaDataTables + // Fills guid (*ppGuid) at index ixGuid from guid heap (#GUID). + // Returns S_OK and fills *ppGuid. Returns S_OK even for (invalid) index 0 (fills *ppGuid with pointer + // to zeros then). + // Retruns error code (if index is invalid except 0, fills NULL and o then). + // Implements public API code:IMetaDataTables::GetGuid. + // Backward compatibility: returns S_OK even if the index is 0 which is invalid as specified in CLI ECMA + // specification. In that case returns pointer to GUID from zeros. + STDMETHODIMP GetGuid( + ULONG ixGuid, // [IN] Value from a guid column. + const GUID **ppGuid); // [OUT] Put a pointer to the GUID here. + + //#GetUserString_IMetaDataTables + // Fills user string (*ppvData of size *pcbDataSize) at index ixUserString. + // Returns S_OK (even for index 0) or error code (if index is invalid, fills NULL and o then). + // Implements public API code:IMetaDataTables::GetUserString. + STDMETHODIMP GetUserString( + ULONG ixUserString, // [IN] Value from a UserString column. + __out ULONG *pcbData, // [OUT] Put size of the UserString here. + __deref_out_opt const void **ppData); // [OUT] Put a pointer to the UserString here. + + //#GetNextString_IMetaDataTables + // Fills index of string (*pixNextString) from the internal strings heap (#String) starting behind + // string at index ixString. + // Returns S_OK or S_FALSE (if either index is invalid). Fills *pixNextString with 0 on S_FALSE. + // Implements public API code:IMetaDataTables::.GetNextString. + STDMETHODIMP GetNextString( + ULONG ixString, // [IN] Value from a string column. + __out ULONG *pixNextString); // [OUT] Put the index of the next string here. + + //#GetNextBlob_IMetaDataTables + // Fills index of blob (*pixNextBlob) from the blobs heap (#Blob) starting behind blob at index ixBlob. + // Returns S_OK or S_FALSE (if either index is invalid). Fills *pixNextBlob with 0 on S_FALSE. + // Implements public API code:IMetaDataTables::GetNextString. + STDMETHODIMP GetNextBlob( + ULONG ixBlob, // [IN] Value from a blob column. + __out ULONG *pixNextBlob); // [OUT] Put the index of the next blob here. + + //#GetNextGuid_IMetaDataTables + // Fills index of guid (*pixNextGuid) from the guids heap (#GUID) starting behind guid at index ixGuid. + // Returns S_OK or S_FALSE (if the new index is invalid). Fills *pixNextGuid with 0 on S_FALSE. + // Implements public API code:IMetaDataTables::GetNextGuid. + // Backward compatibility: returns S_OK even if the guid index (ixGuid) is 0 which is invalid as + // specified in CLI ECMA specification. + STDMETHODIMP GetNextGuid( + ULONG ixGuid, // [IN] Value from a guid column. + __out ULONG *pixNextGuid); // [OUT] Put the index of the next guid here. + + //#GetNextUserString_IMetaDataTables + // Fills index of user string (*pixNextUserString) from the user strings heap (#US) starting behind string + // at index ixUserString. + // Returns S_OK or S_FALSE (if either index is invalid). Fills *pixNextUserString with 0 on S_FALSE. + // Implements public API code:IMetaDataTables::GetNextUserString. + // Backward compatibility: returns S_OK even if the string doesn't have odd number of bytes as specified + // in CLI ECMA specification. + STDMETHODIMP GetNextUserString( + ULONG ixUserString, // [IN] Value from a UserString column. + __out ULONG *ixpNextUserString); // [OUT] Put the index of the next user string here. + + // Implements public API code:IMetaDataTables2::GetMetaDataStorage. + STDMETHODIMP GetMetaDataStorage( + const void **ppvMd, // [OUT] put pointer to MD section here (aka, 'BSJB'). + ULONG *pcbMd); // [OUT] put size of the stream here. + + // Implements public API code:IMetaDataTables2::GetMetaDataStreamInfo. + STDMETHODIMP GetMetaDataStreamInfo( // Get info about the MD stream. + ULONG ix, // [IN] Stream ordinal desired. + const char **ppchName, // [OUT] put pointer to stream name here. + const void **ppv, // [OUT] put pointer to MD stream here. + ULONG *pcb); // [OUT] put size of the stream here. + +#ifndef FEATURE_METADATA_STANDALONE_WINRT + +//***************************************************************************** +// IMetaDataInfo +//***************************************************************************** + + // Returns the memory region of the mapped file and type of its mapping. The choice of the file mapping + // type for each scope is CLR implementation specific and user cannot explicitly set it. + // + // The memory is valid only as long as the underlying MetaData scope is opened (there's a reference to + // a MetaData interface for this scope). + // + // Returns S_OK, COR_E_NOTSUPPORTED (.obj files, etc.), or E_INVALIDARG (if NULL is passed). + // Implements public API code:IMetaDataInfo::GetFileMapping. + STDMETHODIMP GetFileMapping( + const void ** ppvData, // [out] Pointer to the start of the mapped file. + ULONGLONG * pcbData, // [out] Size of the mapped memory region.. + DWORD * pdwMappingType); // [out] Type of file mapping (code:CorFileMapping). + +#endif //!FEATURE_METADATA_STANDALONE_WINRT + +#if defined(FEATURE_METADATA_IN_VM) && defined(FEATURE_PREJIT) + +//***************************************************************************** +// IMetaDataCorProfileData +//***************************************************************************** + + STDMETHOD(SetCorProfileData)( + CorProfileData *pProfileData); // [IN] Pointer to profile data + +//***************************************************************************** +// IMDInternalMetadataReorderingOptions +//***************************************************************************** + + STDMETHOD(SetMetaDataReorderingOptions)( + MetaDataReorderingOptions options); // [IN] metadata reordering options + +#endif //FEATURE_METADATA_IN_VM && FEATURE_PREJIT + +//***************************************************************************** +// IMDCommon methods +//***************************************************************************** + STDMETHOD_(IMetaModelCommon*, GetMetaModelCommon)() + { + return GetMiniMd(); + } + + STDMETHOD_(IMetaModelCommonRO*, GetMetaModelCommonRO)() + { + if (GetMiniMd()->IsWritable()) + { + _ASSERTE(!"IMetaModelCommonRO methods cannot be used because this importer is writable."); + return NULL; + } + return GetMiniMd(); + } + + + // returns the "built for" version of a metadata scope. + __checkReturn + STDMETHOD(GetVersionString)( // S_OK or error. + LPCSTR *pVer); // [OUT] Put version string here. + +//***************************************************************************** +// Helpers. +//***************************************************************************** + + HRESULT MarkAll(); // mark everything in a module + +//***************************************************************************** +// Open / Create support. +//***************************************************************************** + + RegMeta(); + virtual ~RegMeta(); + + HRESULT SetOption(OptionValue *pOptionValue); + + // HRESULT Init(); + // void Cleanup(); + + HRESULT InitWithStgdb( + IUnknown *pUnk, // The IUnknown that owns the life time for the existing stgdb + CLiteWeightStgdbRW *pStgdb); // existing light weight stgdb + + ULONG GetRefCount() { return m_cRef; } + HRESULT AddToCache(); + static HRESULT FindCachedReadOnlyEntry(LPCWSTR szName, DWORD dwOpenFlags, RegMeta **ppMeta); + BOOL IsReadOnly() { return IsOfReadOnly(m_OpenFlags); } + BOOL IsCopyMemory() { return IsOfCopyMemory(m_OpenFlags); } + + + // helper function to reopen RegMeta with a new chuck of memory + HRESULT ReOpenWithMemory( + LPCVOID pData, // [in] Location of scope data. + ULONG cbData, // [in] ReOpen flags + DWORD dwReOpenFlags); // [in] Size of the data pointed to by pData. + + HRESULT CreateNewMD(); + + HRESULT OpenExistingMD( + LPCWSTR szDatabase, // Name of database. + void *pbData, // Data to open on top of, 0 default. + ULONG cbData, // How big is the data. + ULONG dwFlags); // Flags to control open. + +#ifdef FEATURE_METADATA_CUSTOM_DATA_SOURCE + HRESULT OpenExistingMD( + IMDCustomDataSource* pDataSource, // Name of database. + ULONG dwFlags); // Flags to control open. +#endif + + FORCEINLINE CLiteWeightStgdbRW* GetMiniStgdb() { return m_pStgdb; } + FORCEINLINE CMiniMdRW* GetMiniMd() { return &m_pStgdb->m_MiniMd; } + +//***************************************************************************** + + bool IsTypeDefDirty() { return m_fIsTypeDefDirty;} + void SetTypeDefDirty(bool fDirty) { m_fIsTypeDefDirty = fDirty;} + + bool IsMemberDefDirty() { return m_fIsMemberDefDirty;} + void SetMemberDefDirty(bool fDirty) { m_fIsMemberDefDirty = fDirty;} + + FORCEINLINE BOOL IsThreadSafetyOn() + { + return (m_OptionValue.m_ThreadSafetyOptions & MDThreadSafetyOn) == MDThreadSafetyOn; + } + + LPCWSTR GetNameOfDBFile() { return (m_pStgdb->m_wszFileName == NULL) ? W("") : m_pStgdb->m_wszFileName; } + DWORD GetLowFileTimeOfDBFile() { return m_pStgdb->m_dwDatabaseLFT; } + DWORD GetLowFileSizeOfDBFile() { return m_pStgdb->m_dwDatabaseLFS; } +protected: + // Helper functions used for implementation of MetaData APIs. + HRESULT RefToDefOptimization(); + + FORCEINLINE BOOL PreserveLocalRefs(CorLocalRefPreservation localRefType) + { + return (m_OptionValue.m_LocalRefPreservation & localRefType) == localRefType; + } + + HRESULT PreSave(); + HRESULT ProcessFilter(); + HRESULT ProcessFilterWorker(); + + // Initialize the EE + HRESULT StartupEE(); + + // Define a TypeRef given the name. + enum eCheckDups {eCheckDefault=0, eCheckNo=1, eCheckYes=2}; + + HRESULT _DefinePermissionSet( + mdToken tk, // [IN] the object to be decorated. + DWORD dwAction, // [IN] CorDeclSecurity. + void const *pvPermission, // [IN] permission blob. + ULONG cbPermission, // [IN] count of bytes of pvPermission. + mdPermission *ppm); // [OUT] returned permission token. + + HRESULT _DefineTypeRef( + mdToken tkResolutionScope, // [IN] ModuleRef or AssemblyRef. + const void *szName, // [IN] Name of the TypeRef. + BOOL isUnicode, // [IN] Specifies whether the URL is unicode. + mdTypeRef *ptk, // [OUT] Put mdTypeRef here. + eCheckDups eCheck=eCheckDefault); // [IN] Specifies whether to check for duplicates. + + // Define MethodSemantics + HRESULT _DefineMethodSemantics( // S_OK or error. + USHORT usAttr, // [IN] CorMethodSemanticsAttr + mdMethodDef md, // [IN] Method + mdToken tkAssoc, // [IN] Association + BOOL bClear); // [IN] Specifies whether to delete the existing records. + + HRESULT _SaveToStream( // S_OK or error. + IStream *pIStream, // [IN] A writable stream to save to. + DWORD dwSaveFlags); // [IN] Flags for the save. + + HRESULT _SetRVA( // [IN] S_OK or error. + mdToken md, // [IN] Member for which to set offset + ULONG ulCodeRVA, // [IN] The offset + DWORD dwImplFlags); + + HRESULT _DefineEvent( // Return hresult. + mdTypeDef td, // [IN] the class/interface on which the event is being defined + LPCWSTR szEvent, // [IN] Name of the event + DWORD dwEventFlags, // [IN] CorEventAttr + mdToken tkEventType, // [IN] a reference (mdTypeRef or mdTypeRef) to the Event class + mdEvent *pmdEvent); // [OUT] output event token + + // Creates and sets a row in the InterfaceImpl table. Optionally clear + // pre-existing records for the owning class. + HRESULT _SetImplements( // S_OK or error. + mdToken rTk[], // Array of TypeRef or TypeDef tokens for implemented interfaces. + mdTypeDef td, // Implementing TypeDef. + BOOL bClear); // Specifies whether to clear the existing records. + + // Sets flags, name and constraints for a single GenericParam record + HRESULT _SetGenericParamProps( // S_OK or error. + mdGenericParam tkGP, // [IN] Formal parameter token + GenericParamRec *pGenericParam, // [IN] GenericParam record ptr + DWORD dwParamFlags, // [IN] Flags, for future use (e.g. variance) + LPCWSTR szName, // [IN] Optional name + DWORD reserved, // [IN] For future use (e.g. non-type parameters) + mdToken rtkConstraints[]); // [IN] Array of type constraints (TypeDef,TypeRef,TypeSpec) + + HRESULT _SetTypeDefProps( // S_OK or error. + mdTypeDef td, // [IN] The TypeDef. + DWORD dwTypeDefFlags, // [IN] TypeDef flags. + mdToken tkExtends, // [IN] Base TypeDef or TypeRef. + mdToken rtkImplements[]); // [IN] Implemented interfaces. + + HRESULT _SetEventProps1( // Return hresult. + mdEvent ev, // [IN] Event token. + DWORD dwEventFlags, // [IN] Event flags. + mdToken tkEventType); // [IN] Event type class. + + HRESULT _SetEventProps2( // Return hresult. + mdEvent ev, // [IN] Event token. + mdMethodDef mdAddOn, // [IN] Add method. + mdMethodDef mdRemoveOn, // [IN] Remove method. + mdMethodDef mdFire, // [IN] Fire method. + mdMethodDef rmdOtherMethods[], // [IN] An array of other methods. + BOOL bClear); // [IN] Specifies whether to clear the existing MethodSemantics records. + + HRESULT _SetPermissionSetProps( // Return hresult. + mdPermission tkPerm, // [IN] Permission token. + DWORD dwAction, // [IN] CorDeclSecurity. + void const *pvPermission, // [IN] Permission blob. + ULONG cbPermission); // [IN] Count of bytes of pvPermission. + + HRESULT _DefinePinvokeMap( // Return hresult. + mdToken tk, // [IN] FieldDef or MethodDef. + DWORD dwMappingFlags, // [IN] Flags used for mapping. + LPCWSTR szImportName, // [IN] Import name. + mdModuleRef mrImportDLL); // [IN] ModuleRef token for the target DLL. + + HRESULT _DefineSetConstant( // Return hresult. + mdToken tk, // [IN] Parent token. + DWORD dwCPlusTypeFlag, // [IN] Flag for the value type, selected ELEMENT_TYPE_* + void const *pValue, // [IN] Constant value. + ULONG cchString, // [IN] Size of string in wide chars, or -1 for default. + BOOL bSearch); // [IN] Specifies whether to search for an existing record. + + HRESULT _SetMethodProps( // S_OK or error. + mdMethodDef md, // [IN] The MethodDef. + DWORD dwMethodFlags, // [IN] Method attributes. + ULONG ulCodeRVA, // [IN] Code RVA. + DWORD dwImplFlags); // [IN] MethodImpl flags. + + HRESULT _SetFieldProps( // S_OK or error. + mdFieldDef fd, // [IN] The FieldDef. + DWORD dwFieldFlags, // [IN] Field attributes. + DWORD dwCPlusTypeFlag, // [IN] Flag for the value type, selected ELEMENT_TYPE_* + void const *pValue, // [IN] Constant value. + ULONG cchValue); // [IN] size of constant value (string, in wide chars). + + HRESULT _SetClassLayout( // S_OK or error. + mdTypeDef td, // [IN] The class. + ULONG dwPackSize, // [IN] The packing size. + ULONG ulClassSize); // [IN, OPTIONAL] The class size. + + HRESULT _SetFieldOffset( // S_OK or error. + mdFieldDef fd, // [IN] The field. + ULONG ulOffset); // [IN] The offset of the field. + + HRESULT _SetPropertyProps( // S_OK or error. + mdProperty pr, // [IN] Property token. + DWORD dwPropFlags, // [IN] CorPropertyAttr. + DWORD dwCPlusTypeFlag, // [IN] Flag for value type, selected ELEMENT_TYPE_* + void const *pValue, // [IN] Constant value. + ULONG cchValue, // [IN] size of constant value (string, in wide chars). + mdMethodDef mdSetter, // [IN] Setter of the property. + mdMethodDef mdGetter, // [IN] Getter of the property. + mdMethodDef rmdOtherMethods[]); // [IN] Array of other methods. + + HRESULT _SetParamProps( // Return code. + mdParamDef pd, // [IN] Param token. + LPCWSTR szName, // [IN] Param name. + DWORD dwParamFlags, // [IN] Param flags. + DWORD dwCPlusTypeFlag, // [IN] Flag for value type. selected ELEMENT_TYPE_*. + void const *pValue, // [OUT] Constant value. + ULONG cchValue); // [IN] size of constant value (string, in wide chars). + + HRESULT _SetAssemblyProps( // S_OK or error. + mdAssembly pma, // [IN] Assembly token. + const void *pbOriginator, // [IN] Originator of the assembly. + ULONG cbOriginator, // [IN] Count of bytes in the Originator blob. + ULONG ulHashAlgId, // [IN] Hash Algorithm. + LPCWSTR szName, // [IN] Name of the assembly. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + DWORD dwAssemblyFlags); // [IN] Flags. + + HRESULT _SetAssemblyRefProps( // S_OK or error. + mdAssemblyRef ar, // [IN] AssemblyRefToken. + const void *pbPublicKeyOrToken, // [IN] Public key or token of the assembly. + ULONG cbPublicKeyOrToken, // [IN] Count of bytes in the public key or token. + LPCWSTR szName, // [IN] Name of the assembly being referenced. + const ASSEMBLYMETADATA *pMetaData, // [IN] Assembly MetaData. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwAssemblyRefFlags); // [IN] Token for Execution Location. + + HRESULT _SetFileProps( // S_OK or error. + mdFile file, // [IN] File token. + const void *pbHashValue, // [IN] Hash Blob. + ULONG cbHashValue, // [IN] Count of bytes in the Hash Blob. + DWORD dwFileFlags) ; // [IN] Flags. + + HRESULT _SetExportedTypeProps( // S_OK or error. + mdExportedType ct, // [IN] ExportedType token. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the ExportedType. + mdTypeDef tkTypeDef, // [IN] TypeDef token within the file. + DWORD dwExportedTypeFlags); // [IN] Flags. + + HRESULT _SetManifestResourceProps( // S_OK or error. + mdManifestResource mr, // [IN] ManifestResource token. + mdToken tkImplementation, // [IN] mdFile or mdAssemblyRef that provides the resource. + DWORD dwOffset, // [IN] Offset to the beginning of the resource within the file. + DWORD dwResourceFlags); // [IN] Flags. + + HRESULT _DefineTypeDef( // S_OK or error. + LPCWSTR szTypeDef, // [IN] Name of TypeDef + DWORD dwTypeDefFlags, // [IN] CustomAttribute flags + mdToken tkExtends, // [IN] extends this TypeDef or typeref + mdToken rtkImplements[], // [IN] Implements interfaces + mdTypeDef tdEncloser, // [IN] TypeDef token of the Enclosing Type. + mdTypeDef *ptd); // [OUT] Put TypeDef token here + + HRESULT _SetFieldMarshal( + mdToken tk, // [IN] given a fieldDef or paramDef token + PCCOR_SIGNATURE pvNativeType, // [IN] native type specification + ULONG cbNativeType); // [IN] count of bytes of pvNativeType + + HRESULT _IsKnownCustomAttribute( // S_OK, S_FALSE, or error. + mdToken tkType, // [IN] Token of custom attribute's type. + int *pca); // [OUT] Put value from KnownCustAttr enum here. + + HRESULT _DefineModuleRef( // S_OK or error. + LPCWSTR szName, // [IN] DLL name + mdModuleRef *pmur); // [OUT] returned module ref token + + HRESULT _HandleKnownCustomAttribute( // S_OK or error. + mdToken tkObj, // [IN] Object being attributed. + const void *pData, // [IN] Custom Attribute data blob. + ULONG cbData, // [IN] Count of bytes in the data. + int ca, // [IN] Value from KnownCustAttr enum. + int *bKeep); // [OUT} Keep the known CA? + + HRESULT _HandleNativeTypeCustomAttribute(// S_OK or error. + mdToken tkObj, // Object being attributed. + CaArg *pArgs, // Pointer to args. + CaNamedArg *pNamedArgs, // Pointer to named args. + CQuickArray<BYTE> &qNativeType); // Native type is built here. + + // Find a given param of a Method. + HRESULT _FindParamOfMethod( // S_OK or error. + mdMethodDef md, // [IN] The owning method of the param. + ULONG iSeq, // [IN] The sequence # of the param. + mdParamDef *pParamDef); // [OUT] Put ParamDef token here. + + // Given the signature, return the token for signature. + HRESULT _GetTokenFromSig( // S_OK or error. + PCCOR_SIGNATURE pvSig, // [IN] Signature to define. + ULONG cbSig, // [IN] Size of signature data. + mdSignature *pmsig); // [OUT] returned signature token. + + // Turn the specified internal flags on. + HRESULT _TurnInternalFlagsOn( // S_OK or error. + mdToken tkObj, // [IN] Target object whose internal flags are targeted. + DWORD flags); // [IN] Specifies flags to be turned on. + + // This routine eliminates duplicates from the given list of InterfaceImpl tokens + // to be defined. It checks for duplicates against the database only if the + // TypeDef for which these tokens are being defined is not a new one. + HRESULT _InterfaceImplDupProc( // S_OK or error. + mdToken rTk[], // Array of TypeRef or TypeDef tokens for implemented interfaces. + mdTypeDef td, // Implementing TypeDef. + CQuickBytes *pcqbTk); // Quick Byte object for placing the array of unique tokens. + + // Helper : convert a text field signature to a com format + HRESULT _ConvertTextElementTypeToComSig(// Return hresult. + IMetaDataEmit *emit, // [IN] emit interface. + BOOL fCreateTrIfNotFound, // [IN] create typeref if not found or fail out? + LPCSTR *ppOneArgSig, // [IN|OUT] class file format signature. On exit, it will be next arg starting point + CQuickBytes *pqbNewSig, // [OUT] place holder for COM+ signature + ULONG cbStart, // [IN] bytes that are already in pqbNewSig + ULONG *pcbCount); // [OUT] count of bytes put into the QuickBytes buffer + + HRESULT _CheckCmodForCallConv( // S_OK, -1 if found, or error. + PCCOR_SIGNATURE pbSig, // [IN] Signature to check. + ULONG *pcbTotal, // [OUT] Put bytes consumed here. + ULONG *pCallConv); // [OUT] If found, put calling convention here. + + HRESULT _SearchOneArgForCallConv( // S_OK, -1 if found, or error. + PCCOR_SIGNATURE pbSig, // [IN] Signature to check. + ULONG *pcbTotal, // [OUT] Put bytes consumed here. + ULONG *pCallConv); // [OUT] If found, put calling convention here. + + + + int inline IsGlobalMethodParent(mdTypeDef *ptd) + { + if (IsGlobalMethodParentTk(*ptd)) + { + *ptd = m_tdModule; + return (true); + } + return (false); + } + + int inline IsGlobalMethodParentToken(mdTypeDef td) + { + return (!IsNilToken(m_tdModule) && td == m_tdModule); + } + + FORCEINLINE BOOL IsENCOn() + { + _ASSERTE( ((m_OptionValue.m_UpdateMode & MDUpdateMask) == MDUpdateENC) == + m_pStgdb->m_MiniMd.IsENCOn() ); + return (m_OptionValue.m_UpdateMode & MDUpdateMask) == MDUpdateENC; + } + + FORCEINLINE BOOL IsIncrementalOn() + { + return (m_OptionValue.m_UpdateMode & MDUpdateMask) == MDUpdateIncremental; + } + + FORCEINLINE BOOL CheckDups(CorCheckDuplicatesFor checkdup) + { + return ((m_OptionValue.m_DupCheck & checkdup) || + (m_OptionValue.m_UpdateMode == MDUpdateIncremental || + m_OptionValue.m_UpdateMode == MDUpdateENC) ); + } + + FORCEINLINE HRESULT UpdateENCLog(mdToken tk, CMiniMdRW::eDeltaFuncs funccode = CMiniMdRW::eDeltaFuncDefault) + { + _ASSERTE( ((m_OptionValue.m_UpdateMode & MDUpdateMask) == MDUpdateENC) == + m_pStgdb->m_MiniMd.IsENCOn() ); + return m_pStgdb->m_MiniMd.UpdateENCLog(tk, funccode); + } + + FORCEINLINE HRESULT UpdateENCLog2(ULONG ixTbl, ULONG iRid, CMiniMdRW::eDeltaFuncs funccode = CMiniMdRW::eDeltaFuncDefault) + { + _ASSERTE( ((m_OptionValue.m_UpdateMode & MDUpdateMask) == MDUpdateENC) == + m_pStgdb->m_MiniMd.IsENCOn() ); + return m_pStgdb->m_MiniMd.UpdateENCLog2(ixTbl, iRid, funccode); + } + + FORCEINLINE bool IsCallerDefine() { return m_SetAPICaller == DEFINE_API; } + FORCEINLINE void SetCallerDefine() { m_SetAPICaller = DEFINE_API; } + FORCEINLINE bool IsCallerExternal() { return m_SetAPICaller == EXTERNAL_CALLER; } + FORCEINLINE void SetCallerExternal() { m_SetAPICaller = EXTERNAL_CALLER; } + +#ifdef FEATURE_METADATA_RELEASE_MEMORY_ON_REOPEN + bool IsSafeToDeleteStgdb() + { + return m_safeToDeleteStgdb && m_pStgdb->m_MiniMd.IsSafeToDelete(); + } + + FORCEINLINE void MarkUnsafeToDeleteStgdb() { m_safeToDeleteStgdb = false; } + FORCEINLINE void MarkSafeToDeleteStgdb() { m_safeToDeleteStgdb = true; } +#endif + + // Define Validate methods for all tables. +#undef MiniMdTable +#define MiniMdTable(x) HRESULT Validate##x(RID rid); + MiniMdTables() + + // Validate a record in a generic sense using Meta-Meta data. + STDMETHODIMP ValidateRecord(ULONG ixTbl, ULONG ulRow); + + // Validate if the signature is properly formed with regards to the + // compression scheme. + STDMETHODIMP ValidateSigCompression( + mdToken tk, // [IN] Token whose signature needs to be validated. + PCCOR_SIGNATURE pbSig, // [IN] Signature. + ULONG cbSig); // [IN] Size in bytes of the signature. + + // Validate one argument given the offset to the beginning of the + // argument, size of the full signature and the currentl offset value. + STDMETHODIMP ValidateOneArg( + mdToken tk, // [IN] Token whose signature is being processed. + PCCOR_SIGNATURE &pbSig, // [IN] Pointer to the beginning of argument. + ULONG cbSig, // [IN] Size in bytes of the full signature. + ULONG *pulCurByte, // [IN/OUT] Current offset into the signature.. + ULONG *pulNSentinels, // [IN/OUT] Number of sentinels + BOOL bNoVoidAllowed); // [IN] Flag indicating whether "void" is disallowed for this arg + + // Validate the given Method signature. + STDMETHODIMP ValidateMethodSig( + mdToken tk, // [IN] Token whose signature needs to be validated. + PCCOR_SIGNATURE pbSig, // [IN] Signature. + ULONG cbSig, // [IN] Size in bytes of the signature. + DWORD dwFlags); // [IN] Method flags. + + // Validate the given Field signature. + STDMETHODIMP ValidateFieldSig( + mdToken tk, // [IN] Token whose signature needs to be validated. + PCCOR_SIGNATURE pbSig, // [IN] Signature. + ULONG cbSig); // [IN] Size in bytes of the signature. + + // Validate the given MethodSpec signature. + STDMETHODIMP ValidateMethodSpecSig( + mdMethodSpec tk, // [IN] Token whose signature needs to be validated. + PCCOR_SIGNATURE pbSig, // [IN] Signature. + ULONG cbSig, // [IN] Size in bytes of the signature. + ULONG *ulArity); // [OUT] Arity of the instantiation. + + +protected: + + // This scope's Stgdb. This stores the actual data which the class then exposes. + // This storage may be shared by an internal metadata object too. + // This is read-write so that the RegMeta class can implement the emit interfaces. + CLiteWeightStgdbRW *m_pStgdb; + + CLiteWeightStgdbRW *m_pStgdbFreeList; // This scope's Stgdb. + mdTypeDef m_tdModule; // The global module. + IUnknown *m_pUnk; // The IUnknown that owns the Stgdb. + FilterManager *m_pFilterManager; // Contains helper functions for marking + +#ifdef FEATURE_METADATA_INTERNAL_APIS + // Pointer to internal interface. This is a weak reference (it doesn't addref/release). + IMDInternalImport *m_pInternalImport; +#endif //FEATURE_METADATA_INTERNAL_APIS + + UTSemReadWrite *m_pSemReadWrite; + bool m_fOwnSem; + + unsigned m_bRemap : 1; // If true, there is a token mapper. + unsigned m_bSaveOptimized : 1; // If true, save optimization has been done. + unsigned m_hasOptimizedRefToDef : 1; // true if we have performed ref to def optimization + IUnknown *m_pHandler; + bool m_fIsTypeDefDirty; // This flag is set when the TypeRef to TypeDef map is not valid + bool m_fIsMemberDefDirty; // This flag is set when the MemberRef to MemberDef map is not valid + bool m_fStartedEE; // Set when EE runtime has been started up. +#ifdef FEATURE_INCLUDE_ALL_INTERFACES + ICorRuntimeHost *m_pCorHost; // Hosting environment for EE runtime. +#endif // FEATURE_INCLUDE_ALL_INTERFACES + IUnknown *m_pAppDomain; // AppDomain in which managed security code will be run. + +private: + ULONG m_OpenFlags; // Open time flags. + + LONG m_cRef; // Ref count. +#ifdef FEATURE_METADATA_EMIT_ALL + NEWMERGER m_newMerger; // class for handling merge +#endif //FEATURE_METADATA_EMIT_ALL + IUnknown *m_pFreeThreadedMarshaler; // FreeThreadedMarshaler + +#ifdef FEATURE_METADATA_PERF_STATS + MDCompilerPerf m_MDCompilerPerf; // Compiler perf object to store all stats. +#endif + + // If true, cached in list of global scopes. This is very dangerous because it may allow + // unpredictable state sharing between seemingly unrelated dispensers. + bool m_bCached; + + OptionValue m_OptionValue; + + mdTypeRef m_trLanguageType; + + // Specifies whether the caller of the Set API is one of the Define functions + // or an external API. This allows for performance optimization in the Set APIs + // by not checking for Duplicates in certain cases. + SetAPICallerType m_SetAPICaller; + + CorValidatorModuleType m_ModuleType; + IVEHandler *m_pVEHandler; +#ifndef FEATURE_CORECLR + ValidateRecordFunction m_ValidateRecordFunctionTable[TBL_COUNT]; +#endif + CCustAttrHash m_caHash; // Hashed list of custom attribute types seen. + + bool m_bKeepKnownCa; // Should all known CA's be kept? + + CorProfileData *m_pCorProfileData; + + MetaDataReorderingOptions m_ReorderingOptions; + +#ifdef FEATURE_METADATA_RELEASE_MEMORY_ON_REOPEN + bool m_safeToDeleteStgdb; // This starts out true, but gets set to FALSE if we detect + // a RegMeta API call that might have given out an internal pointer. + // There is an equivalent state in MiniMD, and both must be + // TRUE in order to delete safely. +#endif + + HRESULT _ValidateErrorHelper( + HRESULT VECode, + VEContext Context); + + HRESULT _ValidateErrorHelper( + HRESULT VECode, + VEContext Context, + ULONG ulVal1); + + HRESULT _ValidateErrorHelper( + HRESULT VECode, + VEContext Context, + ULONG ulVal1, + ULONG ulVal2); + + HRESULT _ValidateErrorHelper( + HRESULT VECode, + VEContext Context, + ULONG ulVal1, + ULONG ulVal2, + ULONG ulVal3); + +private: + // Returns pointer to zeros of size (cbSize). + // Used by public APIs to return compatible values with previous releases. + static const BYTE *GetPublicApiCompatibilityZerosOfSize(UINT32 cbSize); + // Returns pointer to zeros typed as type T. + // Used by public APIs to return compatible values with previous releases. + template<class T> + T *GetPublicApiCompatibilityZeros() + { + static_assert_no_msg(sizeof(T) <= sizeof(s_rgMetaDataPublicApiCompatibilityZeros)); + return reinterpret_cast<T *>(s_rgMetaDataPublicApiCompatibilityZeros); + } + // Zeros used by public APIs as return value (or pointer to this memory) for invalid input. + // It is used by methods: + // * code:RegMeta::GetPublicApiCompatibilityZeros, and + // * code:RegMeta::GetPublicApiCompatibilityZerosOfSize. + static const BYTE s_rgMetaDataPublicApiCompatibilityZeros[64]; + +}; // class RegMeta + + +#endif // __RegMeta__h__ |