1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
|
// 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.
//*****************************************************************************
// MDInternalRO.h
//
//
// Contains utility code for MD directory
//
//*****************************************************************************
#ifndef __MDInternalRO__h__
#define __MDInternalRO__h__
#include "winmdinterfaces.h"
#ifdef FEATURE_METADATA_INTERNAL_APIS
class MDInternalRO : public IMDInternalImport, IMDCommon
{
public:
MDInternalRO();
virtual ~MDInternalRO();
__checkReturn
HRESULT Init(LPVOID pData, ULONG cbData);
// *** IUnknown methods ***
__checkReturn
STDMETHODIMP QueryInterface(REFIID riid, void** ppv);
STDMETHODIMP_(ULONG) AddRef(void);
STDMETHODIMP_(ULONG) Release(void);
__checkReturn
STDMETHODIMP TranslateSigWithScope(
IMDInternalImport *pAssemImport, // [IN] import assembly scope.
const void *pbHashValue, // [IN] hash value for the import assembly.
ULONG cbHashValue, // [IN] count of bytes in the hash value.
PCCOR_SIGNATURE pbSigBlob, // [IN] signature in the importing scope
ULONG cbSigBlob, // [IN] count of bytes of signature
IMetaDataAssemblyEmit *pAssemEmit, // [IN] assembly emit scope.
IMetaDataEmit *emit, // [IN] emit interface
CQuickBytes *pqkSigEmit, // [OUT] buffer to hold translated signature
ULONG *pcbSig) // [OUT] count of bytes in the translated signature
DAC_UNEXPECTED();
__checkReturn
STDMETHODIMP GetTypeDefRefTokenInTypeSpec(// return S_FALSE if enclosing type does not have a token
mdTypeSpec tkTypeSpec, // [IN] TypeSpec token to look at
mdToken *tkEnclosedToken); // [OUT] The enclosed type token
STDMETHODIMP_(IMetaModelCommon*) GetMetaModelCommon()
{
return static_cast<IMetaModelCommon*>(&m_LiteWeightStgdb.m_MiniMd);
}
STDMETHODIMP_(IMetaModelCommonRO*) GetMetaModelCommonRO()
{
if (m_LiteWeightStgdb.m_MiniMd.IsWritable())
{
_ASSERTE(!"IMetaModelCommonRO methods cannot be used because this importer is writable.");
return NULL;
}
return static_cast<IMetaModelCommonRO*>(&m_LiteWeightStgdb.m_MiniMd);
}
__checkReturn
STDMETHODIMP SetOptimizeAccessForSpeed(
BOOL fOptSpeed)
{
#ifdef FEATURE_PREJIT
// The metadata cache of hot items is an optional working-set optimization
// that has a large speed cost relative to direct table lookup
if (fOptSpeed)
{ // We want to disable usage of hot data (e.g. in ngen compilation process)
m_LiteWeightStgdb.m_MiniMd.DisableHotDataUsage();
}
#endif
return S_OK;
}
//*****************************************************************************
// return the count of entries of a given kind in a scope
// For example, pass in mdtMethodDef will tell you how many MethodDef
// contained in a scope
//*****************************************************************************
STDMETHODIMP_(ULONG) GetCountWithTokenKind(// return hresult
DWORD tkKind) // [IN] pass in the kind of token.
DAC_UNEXPECTED();
//*****************************************************************************
// enumerator for typedef
//*****************************************************************************
__checkReturn
STDMETHODIMP EnumTypeDefInit( // return hresult
HENUMInternal *phEnum); // [OUT] buffer to fill for enumerator data
STDMETHODIMP_(ULONG) EnumTypeDefGetCount(
HENUMInternal *phEnum); // [IN] the enumerator to retrieve information
STDMETHODIMP_(void) EnumTypeDefReset(
HENUMInternal *phEnum); // [IN] the enumerator to retrieve information
STDMETHODIMP_(bool) EnumTypeDefNext( // return hresult
HENUMInternal *phEnum, // [IN] input enum
mdTypeDef *ptd); // [OUT] return token
STDMETHODIMP_(void) EnumTypeDefClose(
HENUMInternal *phEnum); // [IN] the enumerator to retrieve information
//*****************************************************************************
// enumerator for MethodImpl
//*****************************************************************************
__checkReturn
STDMETHODIMP EnumMethodImplInit( // return hresult
mdTypeDef td, // [IN] TypeDef over which to scope the enumeration.
HENUMInternal *phEnumBody, // [OUT] buffer to fill for enumerator data for MethodBody tokens.
HENUMInternal *phEnumDecl); // [OUT] buffer to fill for enumerator data for MethodDecl tokens.
STDMETHODIMP_(ULONG) EnumMethodImplGetCount(
HENUMInternal *phEnumBody, // [IN] MethodBody enumerator.
HENUMInternal *phEnumDecl); // [IN] MethodDecl enumerator.
STDMETHODIMP_(void) EnumMethodImplReset(
HENUMInternal *phEnumBody, // [IN] MethodBody enumerator.
HENUMInternal *phEnumDecl); // [IN] MethodDecl enumerator.
__checkReturn
STDMETHODIMP EnumMethodImplNext( // return hresult
HENUMInternal *phEnumBody, // [IN] input enum for MethodBody
HENUMInternal *phEnumDecl, // [IN] input enum for MethodDecl
mdToken *ptkBody, // [OUT] return token for MethodBody
mdToken *ptkDecl); // [OUT] return token for MethodDecl
STDMETHODIMP_(void) EnumMethodImplClose(
HENUMInternal *phEnumBody, // [IN] MethodBody enumerator.
HENUMInternal *phEnumDecl); // [IN] MethodDecl enumerator.
//*****************************************
// Enumerator helpers for memberdef, memberref, interfaceimp,
// event, property, param, methodimpl
//*****************************************
__checkReturn
STDMETHODIMP EnumGlobalFunctionsInit( // return hresult
HENUMInternal *phEnum); // [OUT] buffer to fill for enumerator data
__checkReturn
STDMETHODIMP EnumGlobalFieldsInit( // return hresult
HENUMInternal *phEnum); // [OUT] buffer to fill for enumerator data
__checkReturn
STDMETHODIMP EnumInit( // return S_FALSE if record not found
DWORD tkKind, // [IN] which table to work on
mdToken tkParent, // [IN] token to scope the search
HENUMInternal *phEnum); // [OUT] the enumerator to fill
__checkReturn
STDMETHODIMP EnumAllInit( // return S_FALSE if record not found
DWORD tkKind, // [IN] which table to work on
HENUMInternal *phEnum); // [OUT] the enumerator to fill
STDMETHODIMP_(bool) EnumNext(
HENUMInternal *phEnum, // [IN] the enumerator to retrieve information
mdToken *ptk); // [OUT] token to scope the search
STDMETHODIMP_(ULONG) EnumGetCount(
HENUMInternal *phEnum); // [IN] the enumerator to retrieve information
STDMETHODIMP_(void) EnumReset(
HENUMInternal *phEnum); // [IN] the enumerator to be reset
STDMETHODIMP_(void) EnumClose(
HENUMInternal *phEnum); // [IN] the enumerator to be closed
__checkReturn
STDMETHODIMP EnumPermissionSetsInit( // return S_FALSE if record not found
mdToken tkParent, // [IN] token to scope the search
CorDeclSecurity Action, // [IN] Action to scope the search
HENUMInternal *phEnum); // [OUT] the enumerator to fill
__checkReturn
STDMETHODIMP EnumCustomAttributeByNameInit(// return S_FALSE if record not found
mdToken tkParent, // [IN] token to scope the search
LPCSTR szName, // [IN] CustomAttribute's name to scope the search
HENUMInternal *phEnum); // [OUT] the enumerator to fill
__checkReturn
STDMETHODIMP GetParentToken(
mdToken tkChild, // [IN] given child token
mdToken *ptkParent); // [OUT] returning parent
__checkReturn
STDMETHODIMP GetCustomAttributeProps(
mdCustomAttribute at, // [IN] The attribute.
mdToken *ptkType); // [OUT] Put attribute type here.
__checkReturn
STDMETHODIMP GetCustomAttributeAsBlob(
mdCustomAttribute cv, // [IN] given custom attribute token
void const **ppBlob, // [OUT] return the pointer to internal blob
ULONG *pcbSize); // [OUT] return the size of the blob
__checkReturn
STDMETHODIMP GetCustomAttributeByName( // S_OK or error.
mdToken tkObj, // [IN] Object with Custom Attribute.
LPCUTF8 szName, // [IN] Name of desired Custom Attribute.
const void **ppData, // [OUT] Put pointer to data here.
ULONG *pcbData); // [OUT] Put size of data here.
__checkReturn
STDMETHODIMP GetNameOfCustomAttribute( // S_OK or error.
mdCustomAttribute mdAttribute, // [IN] The Custom Attribute
LPCUTF8 *pszNamespace, // [OUT] Namespace of Custom Attribute.
LPCUTF8 *pszName); // [OUT] Name of Custom Attribute.
__checkReturn
STDMETHODIMP SafeAndSlowEnumCustomAttributeByNameInit(// return S_FALSE if record not found
mdToken tkParent, // [IN] token to scope the search
LPCSTR szName, // [IN] CustomAttribute's name to scope the search
HENUMInternal *phEnum); // [OUT] The enumerator
__checkReturn
STDMETHODIMP SafeAndSlowEnumCustomAttributeByNameNext(// return S_FALSE if record not found
mdToken tkParent, // [IN] token to scope the search
LPCSTR szName, // [IN] CustomAttribute's name to scope the search
HENUMInternal *phEnum, // [IN] The enumerator
mdCustomAttribute *mdAttribute); // [OUT] The custom attribute that was found
__checkReturn
STDMETHODIMP GetScopeProps(
LPCSTR *pszName, // [OUT] scope name
GUID *pmvid); // [OUT] version id
// finding a particular method
__checkReturn
STDMETHODIMP FindMethodDef(
mdTypeDef classdef, // [IN] given typedef
LPCSTR 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 *pmd); // [OUT] matching memberdef
// return a iSeq's param given a MethodDef
__checkReturn
STDMETHODIMP 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.
//*****************************************
//
// GetName* functions
//
//*****************************************
// return the name and namespace of typedef
__checkReturn
STDMETHODIMP GetNameOfTypeDef(
mdTypeDef classdef, // given classdef
LPCSTR *pszname, // return class name(unqualified)
LPCSTR *psznamespace); // return the name space name
__checkReturn
STDMETHODIMP GetIsDualOfTypeDef(
mdTypeDef classdef, // [IN] given classdef.
ULONG *pDual); // [OUT] return dual flag here.
__checkReturn
STDMETHODIMP GetIfaceTypeOfTypeDef(
mdTypeDef classdef, // [IN] given classdef.
ULONG *pIface); // [OUT] 0=dual, 1=vtable, 2=dispinterface
// get the name of either methoddef
__checkReturn
STDMETHODIMP GetNameOfMethodDef( // return the name of the memberdef in UTF8
mdMethodDef md, // given memberdef
LPCSTR *pszName);
__checkReturn
STDMETHODIMP GetNameAndSigOfMethodDef(
mdMethodDef methoddef, // [IN] given memberdef
PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to a blob value of COM+ signature
ULONG *pcbSigBlob, // [OUT] count of bytes in the signature blob
LPCSTR *pszName);
// return the name of a FieldDef
__checkReturn
STDMETHODIMP GetNameOfFieldDef(
mdFieldDef fd, // given memberdef
LPCSTR *pszName);
// return the name of typeref
__checkReturn
STDMETHODIMP GetNameOfTypeRef(
mdTypeRef classref, // [IN] given typeref
LPCSTR *psznamespace, // [OUT] return typeref name
LPCSTR *pszname); // [OUT] return typeref namespace
// return the resolutionscope of typeref
__checkReturn
STDMETHODIMP GetResolutionScopeOfTypeRef(
mdTypeRef classref, // given classref
mdToken *ptkResolutionScope);
// return the typeref token given the name.
__checkReturn
STDMETHODIMP FindTypeRefByName(
LPCSTR szNamespace, // [IN] Namespace for the TypeRef.
LPCSTR szName, // [IN] Name of the TypeRef.
mdToken tkResolutionScope, // [IN] Resolution Scope fo the TypeRef.
mdTypeRef *ptk); // [OUT] TypeRef token returned.
// return the TypeDef properties
__checkReturn
STDMETHODIMP GetTypeDefProps( // return hresult
mdTypeDef classdef, // given classdef
DWORD *pdwAttr, // return flags on class, tdPublic, tdAbstract
mdToken *ptkExtends); // [OUT] Put base class TypeDef/TypeRef here.
// return the item's guid
__checkReturn
STDMETHODIMP GetItemGuid( // return hresult
mdToken tkObj, // [IN] given item.
CLSID *pGuid); // [OUT] Put guid here.
// get enclosing class of NestedClass.
__checkReturn
STDMETHODIMP GetNestedClassProps( // S_OK or error
mdTypeDef tkNestedClass, // [IN] NestedClass token.
mdTypeDef *ptkEnclosingClass); // [OUT] EnclosingClass token.
// Get count of Nested classes given the enclosing class.
__checkReturn
STDMETHODIMP GetCountNestedClasses( // return count of Nested classes.
mdTypeDef tkEnclosingClass, // [IN]Enclosing class.
ULONG *pcNestedClassesCount);
// Return array of Nested classes given the enclosing class.
__checkReturn
STDMETHODIMP GetNestedClasses( // Return actual count.
mdTypeDef tkEnclosingClass, // [IN] Enclosing class.
mdTypeDef *rNestedClasses, // [OUT] Array of nested class tokens.
ULONG ulNestedClasses, // [IN] Size of array.
ULONG *pcNestedClasses);
// return the ModuleRef properties
__checkReturn
STDMETHODIMP GetModuleRefProps(
mdModuleRef mur, // [IN] moduleref token
LPCSTR *pszName); // [OUT] buffer to fill with the moduleref name
//*****************************************
//
// GetSig* functions
//
//*****************************************
__checkReturn
STDMETHODIMP GetSigOfMethodDef(
mdMethodDef methoddef, // [IN] given memberdef
ULONG *pcbSigBlob, // [OUT] count of bytes in the signature blob
PCCOR_SIGNATURE *ppSig);
__checkReturn
STDMETHODIMP GetSigOfFieldDef(
mdMethodDef methoddef, // [IN] given memberdef
ULONG *pcbSigBlob, // [OUT] count of bytes in the signature blob
PCCOR_SIGNATURE *ppSig);
__checkReturn
STDMETHODIMP GetSigFromToken(
mdToken tk, // FieldDef, MethodDef, Signature or TypeSpec token
ULONG * pcbSig,
PCCOR_SIGNATURE * ppSig);
//*****************************************
// get method property
//*****************************************
__checkReturn
STDMETHODIMP GetMethodDefProps(
mdMethodDef md, // The method for which to get props.
DWORD *pdwFlags);
__checkReturn
STDMETHODIMP_(ULONG) GetMethodDefSlot(
mdMethodDef mb); // The method for which to get props.
//*****************************************
// return method implementation informaiton, like RVA and implflags
//*****************************************
__checkReturn
STDMETHODIMP GetMethodImplProps(
mdMethodDef tk, // [IN] MethodDef
ULONG *pulCodeRVA, // [OUT] CodeRVA
DWORD *pdwImplFlags); // [OUT] Impl. Flags
//*****************************************************************************
// return the field RVA
//*****************************************************************************
__checkReturn
STDMETHODIMP GetFieldRVA(
mdToken fd, // [IN] FieldDef
ULONG *pulCodeRVA); // [OUT] CodeRVA
//*****************************************************************************
// return the field offset for a given field
//*****************************************************************************
__checkReturn
STDMETHODIMP GetFieldOffset(
mdFieldDef fd, // [IN] fielddef
ULONG *pulOffset); // [OUT] FieldOffset
//*****************************************
// get field property
//*****************************************
__checkReturn
STDMETHODIMP GetFieldDefProps(
mdFieldDef fd, // [IN] given fielddef
DWORD *pdwFlags); // [OUT] return fdPublic, fdPrive, etc flags
//*****************************************************************************
// return default value of a token (could be paramdef, fielddef, or property)
//*****************************************************************************
__checkReturn
STDMETHODIMP GetDefaultValue(
mdToken tk, // [IN] given FieldDef, ParamDef, or Property
MDDefaultValue *pDefaultValue); // [OUT] default value to fill
//*****************************************
// get dispid of a MethodDef or a FieldDef
//*****************************************
__checkReturn
STDMETHODIMP GetDispIdOfMemberDef( // return hresult
mdToken tk, // [IN] given methoddef or fielddef
ULONG *pDispid); // [OUT] Put the dispid here.
//*****************************************
// return TypeRef/TypeDef given an InterfaceImpl token
//*****************************************
__checkReturn
STDMETHODIMP GetTypeOfInterfaceImpl( // return the TypeRef/typedef token for the interfaceimpl
mdInterfaceImpl iiImpl, // given a interfaceimpl
mdToken *ptkType);
//*****************************************
// return information about a generic method instantiation
//*****************************************
__checkReturn
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
//*****************************************
// look up function for TypeDef
//*****************************************
__checkReturn
STDMETHODIMP FindTypeDef(
LPCSTR szNamespace, // [IN] Namespace for the TypeDef.
LPCSTR szName, // [IN] Name of the TypeDef.
mdToken tkEnclosingClass, // [IN] TypeDef/TypeRef of enclosing class.
mdTypeDef *ptypedef); // [OUT] return typedef
__checkReturn
STDMETHODIMP FindTypeDefByGUID(
REFGUID guid, // guid to look up
mdTypeDef *ptypedef); // return typedef
//*****************************************
// return name and sig of a memberref
//*****************************************
__checkReturn
STDMETHODIMP GetNameAndSigOfMemberRef( // return name here
mdMemberRef memberref, // given memberref
PCCOR_SIGNATURE *ppvSigBlob, // [OUT] point to a blob value of COM+ signature
ULONG *pcbSigBlob, // [OUT] count of bytes in the signature blob
LPCSTR *pszName);
//*****************************************************************************
// Given memberref, return the parent. It can be TypeRef, ModuleRef, MethodDef
//*****************************************************************************
__checkReturn
STDMETHODIMP GetParentOfMemberRef(
mdMemberRef memberref, // given memberref
mdToken *ptkParent); // return the parent token
__checkReturn
STDMETHODIMP GetParamDefProps(
mdParamDef paramdef, // given a paramdef
USHORT *pusSequence, // [OUT] slot number for this parameter
DWORD *pdwAttr, // [OUT] flags
LPCSTR *pszName); // [OUT] return the name of the parameter
//******************************************
// property info for method.
//******************************************
__checkReturn
STDMETHODIMP GetPropertyInfoForMethodDef( // Result.
mdMethodDef md, // [IN] memberdef
mdProperty *ppd, // [OUT] put property token here
LPCSTR *pName, // [OUT] put pointer to name here
ULONG *pSemantic) // [OUT] put semantic here
DAC_UNEXPECTED();
//*****************************************
// class layout/sequence information
//*****************************************
__checkReturn
STDMETHODIMP GetClassPackSize( // [OUT] return error if a class doesn't have packsize info
mdTypeDef td, // [IN] give typedef
ULONG *pdwPackSize); // [OUT] return the pack size of the class. 1, 2, 4, 8 or 16
__checkReturn
STDMETHODIMP GetClassTotalSize( // [OUT] return error if a class doesn't have total size info
mdTypeDef td, // [IN] give typedef
ULONG *pdwClassSize); // [OUT] return the total size of the class
__checkReturn
STDMETHODIMP GetClassLayoutInit(
mdTypeDef td, // [IN] give typedef
MD_CLASS_LAYOUT *pLayout); // [OUT] set up the status of query here
__checkReturn
STDMETHODIMP GetClassLayoutNext(
MD_CLASS_LAYOUT *pLayout, // [IN|OUT] set up the status of query here
mdFieldDef *pfd, // [OUT] return the fielddef
ULONG *pulOffset); // [OUT] return the offset/ulSequence associate with it
//*****************************************
// marshal information of a field
//*****************************************
__checkReturn
STDMETHODIMP GetFieldMarshal( // return error if no native type associate with the token
mdFieldDef fd, // [IN] given fielddef
PCCOR_SIGNATURE *pSigNativeType, // [OUT] the native type signature
ULONG *pcbNativeType); // [OUT] the count of bytes of *ppvNativeType
//*****************************************
// property APIs
//*****************************************
// find a property by name
__checkReturn
STDMETHODIMP FindProperty(
mdTypeDef td, // [IN] given a typdef
LPCSTR szPropName, // [IN] property name
mdProperty *pProp); // [OUT] return property token
__checkReturn
STDMETHODIMP GetPropertyProps(
mdProperty prop, // [IN] property token
LPCSTR *szProperty, // [OUT] property name
DWORD *pdwPropFlags, // [OUT] property flags.
PCCOR_SIGNATURE *ppvSig, // [OUT] property type. pointing to meta data internal blob
ULONG *pcbSig); // [OUT] count of bytes in *ppvSig
//**********************************
// Event APIs
//**********************************
__checkReturn
STDMETHODIMP FindEvent(
mdTypeDef td, // [IN] given a typdef
LPCSTR szEventName, // [IN] event name
mdEvent *pEvent); // [OUT] return event token
__checkReturn
STDMETHODIMP GetEventProps( // S_OK, S_FALSE, or error.
mdEvent ev, // [IN] event token
LPCSTR *pszEvent, // [OUT] Event name
DWORD *pdwEventFlags, // [OUT] Event flags.
mdToken *ptkEventType); // [OUT] EventType class
//**********************************
// Generics APIs
//**********************************
__checkReturn
STDMETHODIMP GetGenericParamProps( // S_OK or error.
mdGenericParam rd, // [IN] The type parameter
ULONG* pulSequence, // [OUT] Parameter sequence number
DWORD* pdwAttr, // [OUT] Type parameter flags (for future use)
mdToken *ptOwner, // [OUT] The owner (TypeDef or MethodDef)
DWORD *reserved, // [OUT] The kind (TypeDef/Ref/Spec, for future use)
LPCSTR *szName); // [OUT] The name
__checkReturn
STDMETHODIMP GetGenericParamConstraintProps( // S_OK or error.
mdGenericParamConstraint rd, // [IN] The constraint token
mdGenericParam *ptGenericParam, // [OUT] GenericParam that is constrained
mdToken *ptkConstraintType); // [OUT] TypeDef/Ref/Spec constraint
//**********************************
// find a particular associate of a property or an event
//**********************************
__checkReturn
STDMETHODIMP FindAssociate(
mdToken evprop, // [IN] given a property or event token
DWORD associate, // [IN] given a associate semantics(setter, getter, testdefault, reset, AddOn, RemoveOn, Fire)
mdMethodDef *pmd); // [OUT] return method def token
__checkReturn
STDMETHODIMP EnumAssociateInit(
mdToken evprop, // [IN] given a property or an event token
HENUMInternal *phEnum); // [OUT] cursor to hold the query result
__checkReturn
STDMETHODIMP GetAllAssociates(
HENUMInternal *phEnum, // [IN] query result form GetPropertyAssociateCounts
ASSOCIATE_RECORD *pAssociateRec, // [OUT] struct to fill for output
ULONG cAssociateRec); // [IN] size of the buffer
//**********************************
// Get info about a PermissionSet.
//**********************************
__checkReturn
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.
//****************************************
// Get the String given the String token.
// Returns a pointer to the string, or NULL in case of error.
//****************************************
__checkReturn
STDMETHODIMP GetUserString(
mdString stk, // [IN] the string token.
ULONG *pchString, // [OUT] count of characters in the string.
BOOL *pbIs80Plus, // [OUT] specifies where there are extended characters >= 0x80.
LPCWSTR *pwszUserString);
//*****************************************************************************
// p-invoke APIs.
//*****************************************************************************
__checkReturn
STDMETHODIMP GetPinvokeMap(
mdMethodDef tk, // [IN] FieldDef or MethodDef.
DWORD *pdwMappingFlags, // [OUT] Flags used for mapping.
LPCSTR *pszImportName, // [OUT] Import name.
mdModuleRef *pmrImportDLL); // [OUT] ModuleRef token for the target DLL.
//*****************************************************************************
// Assembly MetaData APIs.
//*****************************************************************************
__checkReturn
STDMETHODIMP GetAssemblyProps(
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.
LPCSTR *pszName, // [OUT] Buffer to fill with name.
AssemblyMetaDataInternal *pMetaData,// [OUT] Assembly MetaData.
DWORD *pdwAssemblyFlags); // [OUT] Flags.
__checkReturn
STDMETHODIMP GetAssemblyRefProps(
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.
LPCSTR *pszName, // [OUT] Buffer to fill with name.
AssemblyMetaDataInternal *pMetaData,// [OUT] Assembly MetaData.
const void **ppbHashValue, // [OUT] Hash blob.
ULONG *pcbHashValue, // [OUT] Count of bytes in the hash blob.
DWORD *pdwAssemblyRefFlags); // [OUT] Flags.
__checkReturn
STDMETHODIMP GetFileProps(
mdFile mdf, // [IN] The File for which to get the properties.
LPCSTR *pszName, // [OUT] Buffer to fill with 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.
__checkReturn
STDMETHODIMP GetExportedTypeProps(
mdExportedType mdct, // [IN] The ExportedType for which to get the properties.
LPCSTR *pszNamespace, // [OUT] Buffer to fill with namespace.
LPCSTR *pszName, // [OUT] Buffer to fill with name.
mdToken *ptkImplementation, // [OUT] mdFile or mdAssemblyRef that provides the ExportedType.
mdTypeDef *ptkTypeDef, // [OUT] TypeDef token within the file.
DWORD *pdwExportedTypeFlags); // [OUT] Flags.
__checkReturn
STDMETHODIMP GetManifestResourceProps(
mdManifestResource mdmr, // [IN] The ManifestResource for which to get the properties.
LPCSTR *pszName, // [OUT] Buffer to fill with 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.
__checkReturn
STDMETHODIMP FindExportedTypeByName( // S_OK or error
LPCSTR szNamespace, // [IN] Namespace of the ExportedType.
LPCSTR szName, // [IN] Name of the ExportedType.
mdExportedType tkEnclosingType, // [IN] Enclosing ExportedType.
mdExportedType *pmct); // [OUT] Put ExportedType token here.
__checkReturn
STDMETHODIMP FindManifestResourceByName(// S_OK or error
LPCSTR szName, // [IN] Name of the resource.
mdManifestResource *pmmr); // [OUT] Put ManifestResource token here.
__checkReturn
STDMETHODIMP GetAssemblyFromScope( // S_OK or error
mdAssembly *ptkAssembly); // [OUT] Put token here.
//***************************************************************************
// return properties regarding a TypeSpec
//***************************************************************************
__checkReturn
STDMETHODIMP GetTypeSpecFromToken( // S_OK or error.
mdTypeSpec typespec, // [IN] Signature token.
PCCOR_SIGNATURE *ppvSig, // [OUT] return pointer to token.
ULONG *pcbSig); // [OUT] return size of signature.
//*****************************************************************************
// This function gets the "built for" version of a metadata scope.
// NOTE: if the scope has never been saved, it will not have a built-for
// version, and an empty string will be returned.
//*****************************************************************************
__checkReturn
STDMETHODIMP GetVersionString( // S_OK or error.
LPCSTR *pVer); // [OUT] Put version string here.
//*****************************************************************************
// helpers to convert a text signature to a com format
//*****************************************************************************
__checkReturn
STDMETHODIMP ConvertTextSigToComSig( // Return hresult.
BOOL fCreateTrIfNotFound, // [IN] create typeref if not found
LPCSTR pSignature, // [IN] class file format signature
CQuickBytes *pqbNewSig, // [OUT] place holder for COM+ signature
ULONG *pcbCount); // [OUT] the result size of signature
__checkReturn
STDMETHODIMP SetUserContextData( // S_OK or E_NOTIMPL
IUnknown *pIUnk) // The user context.
{ return E_NOTIMPL; }
STDMETHODIMP_(BOOL) IsValidToken( // True or False.
mdToken tk); // [IN] Given token.
STDMETHODIMP_(IUnknown *) GetCachedPublicInterface(BOOL fWithLock) { return NULL;} // return the cached public interface
__checkReturn
STDMETHODIMP SetCachedPublicInterface(IUnknown *pUnk) { return E_FAIL;} ;// return hresult
STDMETHODIMP_(UTSemReadWrite*) GetReaderWriterLock() {return NULL;} // return the reader writer lock
__checkReturn
STDMETHODIMP SetReaderWriterLock(UTSemReadWrite *pSem) { return NOERROR; }
STDMETHODIMP_(mdModule) GetModuleFromScope(void);
// Find a paticular method and pass in the signature comparison routine. Very
// helpful when the passed in signature does not come from the same scope.
__checkReturn
STDMETHODIMP FindMethodDefUsingCompare(
mdTypeDef classdef, // [IN] given typedef
LPCSTR 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
PSIGCOMPARE pSignatureCompare, // [IN] Routine to compare signatures
void* pSignatureArgs, // [IN] Additional info to supply the compare function
mdMethodDef *pmd); // [OUT] matching memberdef
//*****************************************************************************
// return the table pointer and size for a given table index
//*****************************************************************************
__checkReturn
STDMETHODIMP GetTableInfoWithIndex(
ULONG index, // [IN] pass in the index
void **pTable, // [OUT] pointer to table at index
void **pTableSize); // [OUT] size of table at index
__checkReturn
STDMETHODIMP ApplyEditAndContinue(
void *pData, // [IN] the delta metadata
ULONG cbData, // [IN] length of pData
IMDInternalImport **ppv); // [OUT] the resulting metadata interface
STDMETHODIMP GetRvaOffsetData(
DWORD *pFirstMethodRvaOffset, // [OUT] Offset (from start of metadata) to the first RVA field in MethodDef table.
DWORD *pMethodDefRecordSize, // [OUT] Size of each record in MethodDef table.
DWORD *pMethodDefCount, // [OUT] Number of records in MethodDef table.
DWORD *pFirstFieldRvaOffset, // [OUT] Offset (from start of metadata) to the first RVA field in FieldRVA table.
DWORD *pFieldRvaRecordSize, // [OUT] Size of each record in FieldRVA table.
DWORD *pFieldRvaCount // [OUT] Number of records in FieldRVA table.
);
CLiteWeightStgdb<CMiniMd> m_LiteWeightStgdb;
private:
struct CMethodSemanticsMap
{
mdToken m_mdMethod; // Method token.
RID m_ridSemantics; // RID of semantics record.
};
CMethodSemanticsMap *m_pMethodSemanticsMap; // Possible array of method semantics pointers, ordered by method token.
#ifndef DACCESS_COMPILE
class CMethodSemanticsMapSorter : public CQuickSort<CMethodSemanticsMap>
{
public:
CMethodSemanticsMapSorter(CMethodSemanticsMap *pBase, int iCount) : CQuickSort<CMethodSemanticsMap>(pBase, iCount) {}
virtual int Compare(CMethodSemanticsMap *psFirst, CMethodSemanticsMap *psSecond);
};
#endif //!DACCESS_COMPILE
class CMethodSemanticsMapSearcher : public CBinarySearch<CMethodSemanticsMap>
{
public:
CMethodSemanticsMapSearcher(const CMethodSemanticsMap *pBase, int iCount) : CBinarySearch<CMethodSemanticsMap>(pBase, iCount) {}
virtual int Compare(const CMethodSemanticsMap *psFirst, const CMethodSemanticsMap *psSecond);
};
static BOOL CompareSignatures(PCCOR_SIGNATURE pvFirstSigBlob, DWORD cbFirstSigBlob,
PCCOR_SIGNATURE pvSecondSigBlob, DWORD cbSecondSigBlob,
void* SigARguments);
mdTypeDef m_tdModule; // <Module> typedef value.
LONG m_cRefs; // Ref count.
public:
STDMETHODIMP_(DWORD) GetMetadataStreamVersion()
{
return (DWORD)m_LiteWeightStgdb.m_MiniMd.m_Schema.m_minor |
((DWORD)m_LiteWeightStgdb.m_MiniMd.m_Schema.m_major << 16);
};
STDMETHODIMP SetVerifiedByTrustedSource(// return hresult
BOOL fVerified)
{
m_LiteWeightStgdb.m_MiniMd.SetVerifiedByTrustedSource(fVerified);
return S_OK;
}
}; // class MDInternalRO
#endif //FEATURE_METADATA_INTERNAL_APIS
#endif // __MDInternalRO__h__
|