向类型说明添加函数说明。
语法
HRESULT AddFuncDesc(
[in] UINT index,
[in] FUNCDESC *pFuncDesc
);
参数
[in] index
类型信息中新 FUNCDESC 的索引。
[in] pFuncDesc
描述函数的 FUNCDESC 结构。 FUNCDESC 中的 bstrIDLInfo 字段应为 null。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
一个或多个参数无效。 |
|
内存不足,无法完成操作。 |
|
无法写入目标。 |
|
内存不足,无法完成操作。 |
|
类型不匹配。 |
注解
索引指定类型信息中函数的顺序。 第一个函数的索引为零。 如果指定的索引比类型信息中的函数数少一个,则返回错误。 调用此函数不会将 FUNCDESC 结构的所有权传递给 ICreateTypeInfo。 因此,调用方仍必须取消分配 FUNCDESC 结构。
如果 TYPEKIND TKIND_MODULE或 oVft 为 (-1 或 0,将忽略 FUNCDESC 的 oVft) (VTBL) 字段的传入虚拟函数表。 此属性是在调用 ICreateTypeInfo::LayOut 时设置的。 如果 TYPEKIND 为TKIND_DISPATCH和双接口,或者TKIND_INTERFACE TYPEKIND,则使用 oVft 值。 如果使用 oVft,则其大小必须是计算机上 (VOID *) 的倍数,否则函数将失败,E_INVALIDARG返回为 HRESULT。
函数 AddFuncDesc 对 TYPEKIND = TKIND_DISPATCH 或 TKIND_INTERFACE 的类使用传入成员标识符 (每个 FUNCDESC 中的 memid) 字段。 如果成员 ID 设置为 MEMBERID_NIL, 则 AddFuncDesc 会将成员 ID 分配给函数。 否则,将忽略每个 FUNCDESC 中的成员 ID 字段。
FUNCDESC 结构中的任何 HREFTYPE 字段都必须由调用 AddFuncDesc 的同一 ITypeInfo 实例生成。
同一属性的 get 和 put 访问器函数必须具有相同的调度标识符 (DISPID) 。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | oaidl.h |