Метод IControlChangeNotify::OnNotify (devicetopology.h)
Метод OnNotify уведомляет клиента при изменении состояния соединителя или подсоединения.
Синтаксис
HRESULT OnNotify(
[in] DWORD dwSenderProcessId,
[in] LPCGUID pguidEventContext
);
Параметры
[in] dwSenderProcessId
Идентификатор процесса клиента, который изменил состояние элемента управления. Если уведомление создается событием оборудования, этот идентификатор процесса будет отличаться от идентификатора процесса клиента. Дополнительные сведения см. в подразделе "Примечания".
[in] pguidEventContext
Указатель на guid контекста для события изменения элемента управления. Клиент, инициирующий изменение элемента управления, предоставляет этот GUID. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Клиент может использовать этот метод для отслеживания изменений управления, внесенных другими процессами и оборудованием. Однако клиент, изменяющий параметр элемента управления, обычно может игнорировать уведомление, которое создает изменение элемента управления. В реализации метода OnNotify клиент может проверить параметры dwSenderProcessId и pguidEventContext , чтобы определить, является ли он или другой клиент источником события изменения элемента управления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | devicetopology.h |