ITypeInfo::GetNames 方法 (oaidl.h)

检索具有指定成员 ID 或属性或方法的名称以及对应于指定函数 ID 的参数的变量。

语法

HRESULT GetNames(
  [in]  MEMBERID memid,
  [out] BSTR     *rgBstrNames,
  [in]  UINT     cMaxNames,
  [out] UINT     *pcNames
);

参数

[in] memid

要返回其名称的成员的 ID。

[out] rgBstrNames

调用方分配的数组。 返回时,每个元素都包含与 成员关联的名称 (或名称) 。

[in] cMaxNames

传入的 rgBstrNames 数组的 长度。

[out] pcNames

rgBstrNames 数组中的名称数。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
成功。
E_INVALIDARG
一个或多个参数无效。
E_OUTOFMEMORY
内存不足,无法完成操作。

注解

调用方必须释放返回的 BSTR 数组。

如果成员 ID 标识使用属性函数实现的属性,则返回属性名称。 对于属性 get 函数,始终返回函数的名称及其参数。

对于属性 put 和 put 引用函数,赋值右侧未命名。 如果 cMaxNames 小于 需要返回函数的所有参数名称,则仅返回第一个 cMaxNames - 1 个参数的名称。 参数名称在数组中返回的顺序与它们在接口 (其他位置的显示顺序相同,例如,与 FUNCDESC 枚举关联的参数数组中的相同顺序) 。

如果类型说明继承自其他类型说明,则此函数将递归到基本类型说明(如有必要)以查找具有所请求成员 ID 的项。

要求

要求
目标平台 Windows
标头 oaidl.h

另请参阅

ITypeInfo