Метод CBaseDispatch.GetIDsOfNames

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод GetIDsOfNames сопоставляет набор имен с соответствующим набором DISPID.

Синтаксис

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Параметры

riid

Ссылка на идентификатор интерфейса (IID), указывающий интерфейс.

rgszNames

Адрес массива строк расширенных символов, содержащих имена для сопоставления.

cNames

Размер массива, заданного параметром rgszNames .

lcid

Контекст языкового стандарта, в котором следует интерпретировать имена. Может иметь значение NULL.

rgdispid

Указатель на массив, получающий DISPID. Каждый элемент объекта получает идентификатор, соответствующий одному из имен, переданных в параметре rgszNames .

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

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

Комментарии

Этот метод ведет себя аналогично методу IDispatch::GetIDsOfNames , но параметр riid указывает интерфейс, для которого требуется извлечь DISPID. (В версии IDispatch параметр riid зарезервирован.)

Если метод возвращает DISP_E_UNKNOWNNAME, возвращенные DISPID содержат DISPID_UNKNOWN для каждой записи, соответствующей неизвестному имени.

Требования

Требование Значение
Заголовок
Ctlutil.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CBaseDispatch

  • Last updated on