Метод IControlInterface::GetIID (devicetopology.h)

Метод GetIID получает идентификатор интерфейса элемента управления для конкретной функции.

Синтаксис

HRESULT GetIID(
  [out] GUID *pIID
);

Параметры

[out] pIID

Указатель на переменную GUID, в которую метод записывает идентификатор интерфейса для конкретной функции интерфейса элемента управления. Дополнительные сведения см. в подразделе "Примечания".

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

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

Комментарии

Объект, представляющий часть (соединитель или подсоединие), имеет два интерфейса управления. Первый — это универсальный интерфейс элемента управления IControlInterface, который содержит методы, общие для всех типов элементов управления. Второй — интерфейс элемента управления для конкретной функции, который содержит методы, применяемые к определенному типу элемента управления. Метод GetIID получает идентификатор второго интерфейса элемента управления. Клиент может предоставить этот идентификатор интерфейса методу IPart::Activate , чтобы создать экземпляр интерфейса для конкретной функции части.

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

Чтобы получить идентификатор интерфейса, используйте оператор __uuidof . Например, идентификатор интерфейса IAudioAutoGainControl определяется следующим образом:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Дополнительные сведения об операторе __uuidof см. в документации по Windows SDK.

Требования

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

Интерфейс IControlInterface