Метод ITypeInfo::GetNames (oaidl.h)

  • Статья

Извлекает переменную с указанным идентификатором члена или именем свойства или метода и параметрами, соответствующими указанному идентификатору функции.

Синтаксис

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

Параметры

[in] memid

Идентификатор элемента, для которого возвращается имя (или имена).

[out] rgBstrNames

Массив, выделенный вызывающим объектом. При возврате каждый из элементов содержит имя (или имена), связанные с элементом.

[in] cMaxNames

Длина переданного массива rgBstrNames .

[out] pcNames

Число имен в массиве rgBstrNames .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
Успешно.
E_INVALIDARG
Один или несколько аргументов недопустимы.
E_OUTOFMEMORY
Недостаточно памяти для завершения операции.

Комментарии

Вызывающий объект должен освободить возвращенный массив BSTR.

Если идентификатор элемента идентифицирует свойство, реализованное с помощью функций свойств, возвращается имя свойства. Для функций property get всегда возвращаются имена функции и ее параметры.

Для функций ссылок property put и put правая часть назначения не называется. Если значение cMaxNames меньше, чем требуется для возврата всех имен параметров функции, возвращаются только имена первых параметров cMaxNames — 1. Имена параметров возвращаются в массиве в том же порядке, в каком они отображаются в другом месте интерфейса (например, в том же порядке в массиве параметров, связанном с перечислением FUNCDESC).

Если описание типа наследуется от другого описания типа, эта функция рекурсивна к описанию базового типа, если это необходимо, чтобы найти элемент с запрошенным идентификатором элемента.

Требования

Требование Значение
Целевая платформа Windows
Header oaidl.h

См. также раздел

ITypeInfo