Метод IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h)

Статья
08/24/2023

Возвращает идентификатор класса (CLSID) из предпочтительного списка, заданного значением индекса.

Синтаксис

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD  pluginType,
  [in]  DWORD  index,
  [out] LPWSTR *selector,
  [out] CLSID  *clsid
);

Параметры

[in] pluginType

Член перечисления MF_Plugin_Type , указывающий тип перечисляемого объекта.

[in] index

Отсчитываемый от нуля индекс извлекаемого идентификатора CLSID.

[out] selector

Получает имя ключа, связанное с ИДЕНТИФИКАТОРом CLSID. Вызывающий объект должен освободить память для возвращаемой строки, вызвав функцию CoTaskMemFree . Дополнительные сведения о формате имен ключей см. в разделе Примечания статьи IMFPluginControl.

[out] clsid

Получает идентификатор CLSID по указанному индексу.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Недопустимый аргумент.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Параметр index выходит за пределы диапазона.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	mfobjects.h (включая Mfidl.h)

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

IMFPluginControl

Поделиться через