업데이트: 2007년 11월
형식 라이브러리 또는 런타임 메타데이터 바이너리와 같은 PE 파일(이식 가능 파일)에서 기존 메타데이터를 가져와 수정하기 위한 메서드를 제공합니다.
interface IMetaDataImport : IUnknown {
HRESULT CloseEnum (
HCORENUM hEnum
);
HRESULT CountEnum (
HCORENUM hEnum,
ULONG *pulCount
);
HRESULT EnumCustomAttributes (
HCORENUM *phEnum,
mdToken tk,
mdToken tkType,
mdCustomAttribute rCustomAttributes[],
ULONG cMax,
ULONG *pcCustomAttributes
);
HRESULT EnumEvents (
HCORENUM *phEnum,
mdTypeDef td,
mdEvent rEvents[],
ULONG cMax,
ULONG *pcEvents
);
HRESULT EnumFields (
HCORENUM *phEnum,
mdTypeDef cl,
mdFieldDef rFields[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumFieldsWithName (
HCORENUM *phEnum,
mdTypeDef cl,
LPCWSTR szName,
mdFieldDef rFields[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumInterfaceImpls (
HCORENUM *phEnum,
mdTypeDef td,
mdInterfaceImpl rImpls[],
ULONG cMax,
ULONG* pcImpls
);
HRESULT EnumMemberRefs (
HCORENUM *phEnum,
mdToken tkParent,
mdMemberRef rMemberRefs[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumMembers (
HCORENUM *phEnum,
mdTypeDef cl,
mdToken rMembers[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumMembersWithName (
HCORENUM *phEnum,
mdTypeDef cl,
LPCWSTR szName,
mdToken rMembers[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumMethodImpls (
HCORENUM *phEnum,
mdTypeDef td,
mdToken rMethodBody[],
mdToken rMethodDecl[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumMethods (
HCORENUM *phEnum,
mdTypeDef cl,
mdMethodDef rMethods[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumMethodSemantics (
HCORENUM *phEnum,
mdMethodDef mb,
mdToken rEventProp[],
ULONG cMax,
ULONG *pcEventProp
);
HRESULT EnumMethodsWithName (
HCORENUM *phEnum,
mdTypeDef cl,
LPCWSTR szName,
mdMethodDef rMethods[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumModuleRefs (
HCORENUM *phEnum,
mdModuleRef rModuleRefs[],
ULONG cMax,
ULONG *pcModuleRefs
);
HRESULT EnumParams (
HCORENUM *phEnum,
mdMethodDef mb,
mdParamDef rParams[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumPermissionSets
HCORENUM *phEnum,
mdToken tk,
DWORD dwActions,
mdPermission rPermission[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumProperties (
HCORENUM *phEnum,
mdTypeDef td,
mdProperty rProperties[],
ULONG cMax,
ULONG *pcProperties
);
HRESULT EnumSignatures (
HCORENUM *phEnum,
mdSignature rSignatures[],
ULONG cMax,
ULONG *pcSignatures
);
HRESULT EnumTypeDefs (
HCORENUM *phEnum,
mdTypeDef rTypeDefs[],
ULONG cMax,
ULONG *pcTypeDefs
);
HRESULT EnumTypeRefs (
HCORENUM *phEnum,
mdTypeRef rTypeRefs[],
ULONG cMax,
ULONG *pcTypeRefs
);
HRESULT EnumTypeSpecs (
HCORENUM *phEnum,
mdTypeSpec rTypeSpecs[],
ULONG cMax,
ULONG *pcTypeSpecs
);
HRESULT EnumUnresolvedMethods (
HCORENUM *phEnum,
mdToken rMethods[],
ULONG cMax,
ULONG *pcTokens
);
HRESULT EnumUserStrings (
HCORENUM *phEnum,
mdString rStrings[],
ULONG cMax,
ULONG *pcStrings
);
HRESULT FindField (
mdTypeDef td,
LPCWSTR szName,
PCCOR_SIGNATURE pvSigBlob,
ULONG cbSigBlob,
mdFieldDef *pmb
);
HRESULT FindMember (
mdTypeDef td,
LPCWSTR szName,
PCCOR_SIGNATURE pvSigBlob,
ULONG cbSigBlob,
mdToken *pmb
);
HRESULT FindMemberRef (
mdTypeRef td,
LPCWSTR szName,
PCCOR_SIGNATURE pvSigBlob,
ULONG cbSigBlob,
mdMemberRef *pmr
);
HRESULT FindMethod (
mdTypeDef td,
LPCWSTR szName,
PCCOR_SIGNATURE pvSigBlob,
ULONG cbSigBlob,
mdMethodDef *pmb
);
HRESULT FindTypeDefByName
LPCWSTR szTypeDef,
mdToken tkEnclosingClass,
mdTypeDef *ptd
);
HRESULT FindTypeRef (
mdToken tkResolutionScope,
LPCWSTR szName,
mdTypeRef *ptr
);
HRESULT GetClassLayout (
mdTypeDef td,
DWORD *pdwPackSize,
COR_FIELD_OFFSET rFieldOffset[],
ULONG cMax,
ULONG *pcFieldOffset,
ULONG *pulClassSize
);
HRESULT GetCustomAttributeByName (
mdToken tkObj,
LPCWSTR szName,
const void **ppData,
ULONG *pcbData
);
HRESULT GetCustomAttributeProps (
mdCustomAttribute cv,
mdToken *ptkObj,
mdToken *ptkType,
void const **ppBlob,
ULONG *pcbSize
);
HRESULT GetEventProps (
mdEvent ev,
mdTypeDef *pClass,
LPCWSTR szEvent,
ULONG cchEvent,
ULONG *pchEvent,
DWORD *pdwEventFlags,
mdToken *ptkEventType,
mdMethodDef *pmdAddOn,
mdMethodDef *pmdRemoveOn,
mdMethodDef *pmdFire,
mdMethodDef rmdOtherMethod[],
ULONG cMax,
ULONG *pcOtherMethod
);
HRESULT GetFieldMarshal (
mdToken tk,
PCCOR_SIGNATURE *ppvNativeType,
ULONG *pcbNativeType
);
HRESULT GetFieldProps (
mdFieldDef mb,
mdTypeDef *pClass,
LPWSTR szField,
ULONG cchField,
ULONG *pchField,
DWORD *pdwAttr,
PCCOR_SIGNATURE *ppvSigBlob,
ULONG *pcbSigBlob,
DWORD *pdwCPlusTypeFlag,
UVCP_CONSTANT *ppValue,
ULONG *pcchValue
);
HRESULT GetInterfaceImplProps (
mdInterfaceImpl iiImpl,
mdTypeDef *pClass,
mdToken *ptkIface)
);
HRESULT GetMemberProps (
mdToken mb,
mdTypeDef *pClass,
LPWSTR szMember,
ULONG cchMember,
ULONG *pchMember,
DWORD *pdwAttr,
PCCOR_SIGNATURE *ppvSigBlob,
ULONG *pcbSigBlob,
ULONG *pulCodeRVA,
DWORD *pdwImplFlags,
DWORD *pdwCPlusTypeFlag,
UVCP_CONSTANT *ppValue,
ULONG *pcchValue
);
HRESULT GetMemberRefProps (
mdMemberRef mr,
mdToken *ptk,
LPWSTR szMember,
ULONG cchMember,
ULONG *pchMember,
PCCOR_SIGNATURE *ppvSigBlob,
ULONG *pbSig
);
HRESULT GetMethodProps (
mdMethodDef mb,
mdTypeDef *pClass,
LPWSTR szMethod,
ULONG cchMethod,
ULONG *pchMethod,
DWORD *pdwAttr,
PCCOR_SIGNATURE *ppvSigBlob,
ULONG *pcbSigBlob,
ULONG *pulCodeRVA,
DWORD *pdwImplFlags
);
HRESULT GetMethodSemantics (
mdMethodDef mb,
mdToken tkEventProp,
DWORD *pdwSemanticsFlags
);
HRESULT GetModuleFromScope (
mdModule *pmd
);
HRESULT GetModuleRefProps (
mdModuleRef mur,
LPWSTR szName,
ULONG cchName,
ULONG *pchName
);
HRESULT GetNameFromToken (
mdToken tk,
MDUTF8CSTR *pszUtf8NamePtr
);
HRESULT GetNativeCallConvFromSig (
void const *pvSig,
ULONG cbSig,
ULONG *pCallConv
);
HRESULT GetNestedClassProps (
mdTypeDef tdNestedClass,
mdTypeDef *ptdEnclosingClass
);
HRESULT GetParamForMethodIndex (
mdMethodDef md,
ULONG ulParamSeq,
mdParamDef *ppd
);
HRESULT GetParamProps (
mdParamDef tk,
mdMethodDef *pmd,
ULONG *pulSequence,
LPWSTR szName,
ULONG cchName,
ULONG *pchName,
DWORD *pdwAttr,
DWORD *pdwCPlusTypeFlag,
UVCP_CONSTANT *ppValue,
ULONG *pcchValue
);
HRESULT GetPermissionSetProps (
mdPermission pm,
DWORD *pdwAction,
void const **ppvPermission,
ULONG *pcbPermission
);
HRESULT GetPinvokeMap (
mdToken tk,
DWORD *pdwMappingFlags,
LPWSTR szImportName,
ULONG cchImportName,
ULONG *pchImportName,
mdModuleRef *pmrImportDLL
);
HRESULT GetPropertyProps (
mdProperty prop,
mdTypeDef *pClass,
LPCWSTR szProperty,
ULONG cchProperty,
ULONG *pchProperty,
DWORD *pdwPropFlags,
PCCOR_SIGNATURE *ppvSig,
ULONG *pbSig,
DWORD *pdwCPlusTypeFlag,
UVCP_CONSTANT *ppDefaultValue,
ULONG *pcchDefaultValue,
mdMethodDef *pmdSetter,
mdMethodDef *pmdGetter,
mdMethodDef rmdOtherMethod[],
ULONG cMax,
ULONG *pcOtherMethod
);
HRESULT GetRVA (
mdToken tk,
ULONG *pulCodeRVA,
DWORD *pdwImplFlags
);
HRESULT GetScopeProps (
LPWSTR szName,
ULONG cchName,
ULONG *pchName,
GUID *pmvid
);
HRESULT GetSigFromToken (
mdSignature mdSig,
PCCOR_SIGNATURE *ppvSig,
ULONG *pcbSig
);
HRESULT GetTypeDefProps
mdTypeDef td,
LPWSTR szTypeDef,
ULONG cchTypeDef,
ULONG *pchTypeDef,
DWORD *pdwTypeDefFlags,
mdToken *ptkExtends
);
HRESULT GetTypeRefProps (
mdTypeRef tr,
mdToken *ptkResolutionScope,
LPWSTR szName,
ULONG cchName,
ULONG *pchName
);
HRESULT GetTypeSpecFromToken (
mdTypeSpec typespec,
PCCOR_SIGNATURE *ppvSig,
ULONG *pcbSig
);
HRESULT GetUserString (
mdString stk,
LPWSTR szString,
ULONG cchString,
ULONG *pchString
);
HRESULT IsGlobal (
mdToken pd,
int *pbGlobal
);
BOOL IsValidToken (
mdToken tk
);
HRESULT ResetEnum (
HCORENUM hEnum,
ULONG ulPos
);
HRESULT ResolveTypeRef (
mdTypeRef tr,
REFIID riid,
IUnknown **ppIScope,
mdTypeDef *ptd
);
};
메서드
메서드 |
설명 |
|---|---|
지정한 핸들에 해당하는 열거자를 닫습니다. |
|
지정한 핸들을 사용하여 열거자의 요소 수를 가져옵니다. |
|
지정된 형식 또는 멤버와 연결된 사용자 지정 특성 정의 토큰의 목록을 열거합니다. |
|
지정된 TypeDef 토큰에 대한 이벤트 정의 토큰을 열거합니다. |
|
지정된 TypeDef 토큰에서 참조하는 형식의 FieldDef 토큰을 열거합니다. |
|
지정된 이름을 갖는 지정된 형식의 FieldDef 토큰을 열거합니다. |
|
인터페이스 구현을 나타내는 MethodDef 토큰을 열거합니다. |
|
지정된 형식의 멤버를 나타내는 MemberRef 토큰을 열거합니다. |
|
지정된 형식의 멤버를 나타내는 MemberDef 토큰을 열거합니다. |
|
지정된 이름을 갖는 지정된 형식의 멤버를 나타내는 MemberDef 토큰을 열거합니다. |
|
지정된 형식의 메서드를 나타내는 MethodBody 및 MethodDeclaration 토큰을 열거합니다. |
|
지정된 형식의 메서드를 나타내는 MethodDef 토큰을 열거합니다. |
|
지정된 메서드와 관련된 속성 및 속성 변경 이벤트를 열거합니다. |
|
지정된 이름의 메서드와 지정된 TypeDef 토큰에서 참조하는 형식에 정의된 메서드를 열거합니다. |
|
가져온 모듈을 나타내는 ModuleRef 토큰을 열거합니다. |
|
지정된 MethodDef 토큰에서 참조하는 메서드의 매개 변수를 나타내는 ParamDef 토큰을 열거합니다. |
|
지정된 메타데이터 범위의 개체에 대한 사용 권한을 열거합니다. |
|
지정된 TypeDef 토큰에서 참조하는 형식의 속성을 나타내는 PropertyDef 토큰을 열거합니다. |
|
현재 범위의 독립 실행형 시그니처를 나타내는 Signature 토큰을 열거합니다. |
|
현재 범위 내의 모든 형식을 나타내는 TypeDef 토큰을 열거합니다. |
|
현재 메타데이터 범위에 정의된 TypeRef 토큰을 열거합니다. |
|
현재 메타데이터 범위에 정의된 TypeSpec 토큰을 열거합니다. |
|
현재 메타데이터 범위의 확인되지 않은 메서드를 나타내는 MemberDef 토큰을 열거합니다. |
|
현재 메타데이터 범위의 하드 코드된 문자열을 나타내는 String 토큰을 열거합니다. |
|
지정한 형식의 멤버이고 지정한 이름과 메타데이터 시그니처를 가진 필드에 대한 FieldDef 토큰을 가져옵니다. |
|
지정된 형식에 정의되어 있고 지정된 이름과 메타데이터 시그니처를 갖는 멤버의 MemberDef 토큰에 대한 포인터를 가져옵니다. |
|
지정된 형식에 정의되어 있고 지정된 이름과 메타데이터 시그니처를 갖는 멤버의 MemberRef 토큰에 대한 포인터를 가져옵니다. |
|
지정된 형식에 정의되어 있고 지정된 이름과 메타데이터 시그니처를 갖는 메서드의 MethodDef 토큰에 대한 포인터를 가져옵니다. |
|
지정된 이름을 갖는 형식의 TypeDef 메타데이터 토큰에 대한 포인터를 가져옵니다. |
|
지정된 검색 범위에서 지정된 이름의 형식을 참조하는 TypeRef 메타데이터 토큰에 대한 포인터를 가져옵니다. |
|
지정한 TypeDef 토큰에서 참조하는 클래스의 레이아웃 정보를 가져옵니다. |
|
지정된 이름을 갖는 사용자 지정 특성의 값을 가져옵니다. |
|
지정된 메타데이터 토큰이 있는 사용자 지정 특성의 값을 가져옵니다. |
|
선언 형식, 대리자의 add/remove 메서드, 플래그 및 관련된 기타 데이터 등을 포함하여 지정된 이벤트 토큰이 나타내는 이벤트에 대한 메타데이터 정보를 가져옵니다. |
|
지정한 Field 메타데이터 토큰이 나타내는 필드의 관리되지 않는 네이티브 형식에 대한 포인터를 가져옵니다. |
|
지정한 FieldDef 토큰에서 참조하는 필드와 연결된 메타데이터를 가져옵니다. |
|
지정된 메서드를 구현하는 형식과 해당 메서드를 선언하는 인터페이스의 메타데이터 토큰에 대한 포인터를 가져옵니다. |
|
지정된 메타데이터 토큰에서 참조하는 형식 멤버의 이름, 이진 시그니처, 상대 가상 주소와 같은 메타데이터 정보를 가져옵니다. |
|
지정한 토큰에서 참조하는 멤버와 연결된 메타데이터를 가져옵니다. |
|
지정한 MethodDef 토큰에서 참조하는 메서드와 연결된 메타데이터를 가져옵니다. |
|
지정한 EventProp 토큰에서 참조하는 속성/이벤트 쌍과 지정한 MethodDef 토큰에서 참조하는 메서드 간의 관계에 대한 포인터를 가져옵니다. |
|
현재 메타데이터 범위에서 참조되는 모듈의 메타데이터 토큰에 대한 포인터를 가져옵니다. |
|
지정한 메타데이터 토큰에서 참조하는 모듈 이름을 가져옵니다. |
|
지정된 메타데이터 토큰에서 참조하는 개체의 UTF-8 이름을 가져옵니다. |
|
지정된 시그니처 포인터가 나타내는 메서드의 네이티브 호출 규칙을 가져옵니다. |
|
지정된 중첩 형식의 바깥쪽 부모 형식에 대한 TypeDef 토큰을 가져옵니다. |
|
지정한 MethodDef 토큰이 나타내는 메서드의 매개 변수 시퀀스에서 지정한 서수 위치에 있는 매개 변수를 나타내는 토큰에 대한 포인터를 가져옵니다. |
|
지정한 ParamDef 토큰에서 참조하는 매개 변수에 대한 메타데이터 값을 가져옵니다. |
|
지정된 Permission 토큰이 나타내는 System.Security.PermissionSet에 연결된 메타데이터를 가져옵니다. |
|
PInvoke 호출의 대상 어셈블리를 나타내기 위해 ModuleRef 토큰을 가져옵니다. |
|
지정한 토큰이 나타내는 속성에 연결된 메타데이터를 가져옵니다. |
|
지정한 토큰이 나타내는 코드 개체의 상대 가상 주소 오프셋을 가져옵니다. |
|
현재 메타데이터 범위에 있는 어셈블리 또는 모듈의 이름과 버전 식별자(선택 사항)를 가져옵니다. |
|
지정한 토큰에 연결된 이진 메타데이터 시그니처를 가져옵니다. |
|
지정된 TypeDef 토큰이 나타내는 형식에 대한 메타데이터 정보를 반환합니다. |
|
지정된 TypeRef 토큰에서 참조하는 형식과 연결된 메타데이터를 가져옵니다. |
|
지정된 토큰이 나타내는 형식 사양의 이진 메타데이터 시그니처를 가져옵니다. |
|
지정한 메타데이터 토큰이 나타내는 리터럴 문자열을 가져옵니다. |
|
지정된 메타데이터 토큰이 나타내는 필드, 메서드 또는 형식이 전역 범위를 사용하는지 여부를 나타내는 값을 가져옵니다. |
|
지정한 토큰에 코드 개체에 대한 올바른 참조를 보관하는지 여부를 나타내는 값을 가져옵니다. |
|
지정한 열거자를 지정한 위치에 다시 설정합니다. |
|
지정된 TypeRef 토큰에서 참조하는 형식에 대한 형식 정보를 가져옵니다. |
설명
IMetaDataImport 인터페이스는 주로 개발 도구와 같이 형식 정보를 가져오거나 확인/활성화 서비스와 같이 배포된 구성 요소를 관리하는 도구 및 서비스에서 사용하기 위한 것입니다. IMetaDataImport의 메서드는 다음 작업 범주로 나눌 수 있습니다.
메타데이터 범위의 항목 컬렉션 열거
특정 문자 집합이 있는 항목 찾기
지정된 항목의 속성 가져오기
Get 메서드는 특히 메타데이터 항목의 단일 값 속성을 반환하기 위한 것입니다. 이 속성이 다른 항목에 대한 참조이면 해당 항목의 토큰이 반환됩니다. 모든 포인터 형식은 특정 값이 요청되지 않음을 나타내는 NULL일 수 있습니다. 클래스에 구현된 인터페이스 컬렉션과 같이 기본적으로 컬렉션 개체에 해당하는 속성을 가져오려면 열거 메서드를 사용합니다.
요구 사항
플랫폼:.NET Framework 시스템 요구 사항 참조
헤더: Cor.h
라이브러리: MsCorEE.dll에서 리소스로 사용됨
.NET Framework 버전: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0