使用指定的签名中,创建方法或全局函数的定义,并将令牌返回到该方法定义。
语法
HRESULT DefineMethod (
[in] mdTypeDef td,
[in] LPCWSTR szName,
[in] DWORD dwMethodFlags,
[in] PCCOR_SIGNATURE pvSigBlob,
[in] ULONG cbSigBlob,
[in] ULONG ulCodeRVA,
[in] DWORD dwImplFlags,
[out] mdMethodDef *pmd
);
参数
td
[in]mdTypedef父类或父接口的方法的令牌。 设置td到mdTokenNil,如果您要定义全局函数。
szName
[in]Unicode 中的成员名称。
dwMethodFlags
[in]值为CorMethodAttr枚举,用于指定方法或全局函数的属性。
pvSigBlob
[in]方法签名中。 保存签名中提供。 如果您需要指定任何参数的其他信息,请使用imetadataemit:: Setparamprops方法。
cbSigBlob
[in]中的字节计数pvSigBlob。
ulCodeRVA
[in]代码的地址。
dwImplFlags
[in]值为CorMethodImpl枚举,用于指定该方法的实现功能。
pmd
[out]成员标记中。
备注
元数据 API 可保证按给定的封闭类或接口中指定的调用方发出这些方法的相同顺序保留td参数。
有关使用的其他信息DefineMethod和特定参数设置如下。
V-表中的槽
运行时使用的方法定义以设置 v 表槽。 在一个或多个槽需要是已跳过、 此类情况下并保持与 COM 接口布局相同的虚拟方法定义为采用槽或 v-表; 中的槽设置dwMethodFlags到mdRTSpecialName的值CorMethodAttr枚举和名称指定为:
_VtblGap<SequenceNumber><_CountOfSlots>
其中SequenceNumber是方法的序列号和槽数是要跳过 v 表中的槽数。 如果槽数是省略,则假定为 1。 这些虚拟方法不能从托管或非托管代码调用,任何尝试从托管或非托管代码中调用它们,将引发异常。 其唯一用途是占用空间为 COM 集成运行时生成的 v 表中。
重复的方法
不应定义重复的方法。 也就是说,不应调用DefineMethod中的值重复一td, wzName,和pvSig参数。 (这三个参数组合在一起唯一地定义的方法。)。 但是,可以使用重复三次,前提是,对于其中一个方法定义,您将设置mdPrivateScope位dwMethodFlags参数。 (mdPrivateScope位意味着编译器将发出对此方法定义的引用。)
方法的实施信息
声明的方法时通常不知道有关方法实现的信息。 因此,不需要传递中的值ulCodeRVA并dwImplFlags参数调用时DefineMethod。 可以通过更高版本提供的值imetadataemit:: Setmethodimplflags或imetadataemit:: Setrva根据。
在某些情况下,如平台调用 (PInvoke) 或 COM 互操作方案中,未将提供方法正文,和ulCodeRVA应设置为零。 在这些情况下,该方法不应将标记为抽象,因为运行时将查找其实现。
定义一个方法的 PInvoke
若要通过 PInvoke 调用每个非托管函数,必须定义表示目标的非托管函数的托管的方法。 若要定义的托管的方法,请使用DefineMethod某些设置为特定值,具体取决于 PInvoke 的使用方式的参数:
-
True PInvoke-涉及到驻留在非托管 DLL 的外部的非托管方法的调用。
-
本地 PInvoke-涉及到在当前托管模块中嵌入本机非托管方法的调用。
下表中提供的参数设置。
| 参数 | 值为 true 的 PInvoke 的 | 值为本地 PInvoke 的 |
|---|---|---|
dwMethodFlags |
设置mdStatic; 清除mdSynchronized和mdAbstract。 |
|
pvSigBlob |
一个有效的公共语言运行时 (CLR) 方法签名,使用有效的参数将托管类型。 | 使用有效的参数有效的 CLR 方法签名的托管类型。 |
ulCodeRVA |
0 | |
dwImplFlags |
设置miCil和miManaged。 |
设置miNative和miUnmanaged。 |
要求
平台: 请参阅系统需求。
标头: Cor.h
库: 用作 MSCorEE.dll 中的资源
.NET Framework 版本: 自 1.0 之后可用
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
