Метод IPart::GetControlInterface (devicetopology.h)

Статья
08/23/2023

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

Синтаксис

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Параметры

[in] nIndex

Номер интерфейса элемента управления. Если часть поддерживает n интерфейсов управления, интерфейсы элементов управления нумеруются от 0 до n–1.

[out] ppInterfaceDesc

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IControlInterface указанной звуковой функции. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс. Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetControlInterface завершается сбоем, *ppFunction имеет значение NULL.

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

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

Код возврата	Описание
E_POINTER	Указатель ppFunction имеет значение NULL.
E_INVALIDARG	Параметр nIndex выходит за пределы диапазона.
E_NOTFOUND	Часть не имеет интерфейса управления.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	devicetopology.h

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

Интерфейс IControlInterface

Интерфейс IPart