Método IControlChangeNotify::OnNotify (devicetopology.h)

O método OnNotify notifica o cliente quando o status de um conector ou subunidade é alterado.

Sintaxe

HRESULT OnNotify(
  [in] DWORD   dwSenderProcessId,
  [in] LPCGUID pguidEventContext
);

Parâmetros

[in] dwSenderProcessId

A ID do processo do cliente que alterou o estado do controle. Se uma notificação for gerada por um evento de hardware, essa ID de processo será diferente da ID do processo do cliente. Para obter mais informações, consulte Comentários.

[in] pguidEventContext

Um ponteiro para o GUID de contexto para o evento control-change. O cliente que inicia a alteração de controle fornece esse GUID. Para obter mais informações, consulte Comentários.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Um cliente pode usar esse método para controlar as alterações de controle feitas por outros processos e pelo hardware. No entanto, um cliente que altera uma configuração de controle normalmente pode ignorar a notificação gerada pela alteração de controle. Em sua implementação do método OnNotify , um cliente pode inspecionar os parâmetros dwSenderProcessId e pguidEventContext para descobrir se ele ou outro cliente é a origem do evento control-change.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IControlChangeNotify Interface